@lark-base-open/base-database-cli 1.4.6 → 1.4.9

package/dist/source-format.d.ts

@@ -1,4 +1,7 @@
 export declare const SOURCE_FORMAT = 1;
+export declare const MAX_SOURCE_ARCHIVE_MIB = 50;
+export declare const MAX_SOURCE_ARCHIVE_BYTES: number;
+export declare function compressedSourceArchiveSizeError(size: number): string;
 interface SourceFormat {
     format: number;
     minCli: string;

package/dist/source-format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-format.d.ts","sourceRoot":"","sources":["../src/source-format.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,aAAa,IAAI,CAAC;AAG/B,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAe7C;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAgC1E"}
+{"version":3,"file":"source-format.d.ts","sourceRoot":"","sources":["../src/source-format.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,wBAAwB,QAAuC,CAAC;AAG7E,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAe7C;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAgC1E"}

package/dist/source-format.js

@@ -2,7 +2,13 @@ import { existsSync, readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { packageRoot } from './assets.js';
 export const SOURCE_FORMAT = 1;
+// Keep publishing and restoring aligned with UploadArtifact on the server.
+export const MAX_SOURCE_ARCHIVE_MIB = 50;
+export const MAX_SOURCE_ARCHIVE_BYTES = MAX_SOURCE_ARCHIVE_MIB * 1024 * 1024;
 const MIN_SOURCE_CLI = '1.4.1';
+export function compressedSourceArchiveSizeError(size) {
+    return `Compressed source archive is ${size} bytes, exceeds ${MAX_SOURCE_ARCHIVE_MIB} MiB (${MAX_SOURCE_ARCHIVE_BYTES} bytes)`;
+}
 export function sourceArchiveComment() {
     // 内部分发的共享源码位于 dist/src，包版本在 dist 的上一级。
     const root = existsSync(join(packageRoot, 'package.json'))

package/dist/source-format.js.map

@@ -1 +1 @@
-{"version":3,"file":"source-format.js","sourceRoot":"","sources":["../src/source-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAC/B,MAAM,cAAc,GAAG,OAAO,CAAC;AAQ/B,MAAM,UAAU,oBAAoB;IAClC,uCAAuC;IACvC,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QACxD,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACzB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CACjD,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,kBAAkB,EAAE;YAClB,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,cAAc;YACtB,GAAG,EAAE,OAAO;SACb;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,KAAK,EAAE,kBAAkB,CAAC;QACzC,IACE,KAAK;YACL,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACrB,MAAM,KAAK,SAAS;YAEpB,OAAO,SAAS,CAAC;QACnB,IACE,CAAC,MAAM;YACP,OAAO,MAAM,KAAK,QAAQ;YAC1B,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YACrB,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC;YACpC,MAAM,CAAC,MAAM,GAAG,CAAC;YACjB,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;YACjC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;YACrB,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ;YAC9B,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE;YAElB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,4BAA4B;QAC5B,OAAO,CAAC,IAAI,CACV,iGAAiG,CAClG,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}
+{"version":3,"file":"source-format.js","sourceRoot":"","sources":["../src/source-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAC/B,2EAA2E;AAC3E,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AACzC,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,GAAG,IAAI,GAAG,IAAI,CAAC;AAC7E,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,MAAM,UAAU,gCAAgC,CAAC,IAAY;IAC3D,OAAO,gCAAgC,IAAI,mBAAmB,sBAAsB,SAAS,wBAAwB,SAAS,CAAC;AACjI,CAAC;AAQD,MAAM,UAAU,oBAAoB;IAClC,uCAAuC;IACvC,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QACxD,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACzB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CACjD,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,kBAAkB,EAAE;YAClB,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,cAAc;YACtB,GAAG,EAAE,OAAO;SACb;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,KAAK,EAAE,kBAAkB,CAAC;QACzC,IACE,KAAK;YACL,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACrB,MAAM,KAAK,SAAS;YAEpB,OAAO,SAAS,CAAC;QACnB,IACE,CAAC,MAAM;YACP,OAAO,MAAM,KAAK,QAAQ;YAC1B,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YACrB,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC;YACpC,MAAM,CAAC,MAAM,GAAG,CAAC;YACjB,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;YACjC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;YACrB,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ;YAC9B,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE;YAElB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,4BAA4B;QAC5B,OAAO,CAAC,IAAI,CACV,iGAAiG,CAClG,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/unified-functions.d.ts

@@ -6,11 +6,20 @@ export interface FunctionWrite {
     functionType: FunctionKind;
     spec: string;
 }
+export interface PutFunctionsOptions {
+    token: string;
+    kinds: FunctionKind[];
+    functions: FunctionWrite[];
+    env: NodeJS.ProcessEnv;
+    cwd?: string;
+}
+export type ValidateFunctionsOptions = PutFunctionsOptions;
 export declare function functionEnv(value?: string): 'preview' | 'prod';
 export declare function assertFunctionResults(data: Record<string, unknown>, expectedIds: readonly string[]): string[];
-export declare function putFunctions(token: string, kinds: FunctionKind[], functions: FunctionWrite[], env: NodeJS.ProcessEnv, cwd?: string): Record<string, unknown> & {
+export declare function putFunctions(options: PutFunctionsOptions): Record<string, unknown> & {
     deletedFunctionIds: string[];
 };
+export declare function validateFunctions(options: ValidateFunctionsOptions): Record<string, unknown>;
 export interface FunctionPageState {
     pages: number;
     snapshot?: string;

package/dist/unified-functions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unified-functions.d.ts","sourceRoot":"","sources":["../src/unified-functions.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;AAC9D,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,YAAY,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AACD,wBAAgB,WAAW,CAAC,KAAK,GAAE,MAAkB,GAAG,SAAS,GAAG,MAAM,CAIzE;AACD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,MAAM,EAAE,CA4BV;AACD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,YAAY,EAAE,EACrB,SAAS,EAAE,aAAa,EAAE,EAC1B,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,kBAAkB,EAAE,MAAM,EAAE,CAAA;CAAE,CAmB5D;AACD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAClB;AACD,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,iBAAiB,EACxB,KAAK,CAAC,EAAE,MAAM,EACd,GAAG,SAAsB,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CA0C3B;AACD,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,GAAG,CAAC,EAAE,MAAM,EACZ,GAAG,SAAsB,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAoC3B;AACD,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB"}
+{"version":3,"file":"unified-functions.d.ts","sourceRoot":"","sources":["../src/unified-functions.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;AAC9D,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,YAAY,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AACD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AACD,MAAM,MAAM,wBAAwB,GAAG,mBAAmB,CAAC;AAC3D,wBAAgB,WAAW,CAAC,KAAK,GAAE,MAAkB,GAAG,SAAS,GAAG,MAAM,CAIzE;AACD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,MAAM,EAAE,CA6BV;AACD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,mBAAmB,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,kBAAkB,EAAE,MAAM,EAAE,CAAA;CAAE,CAsB5D;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBzB;AACD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAClB;AACD,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,iBAAiB,EACxB,KAAK,CAAC,EAAE,MAAM,EACd,GAAG,SAAsB,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CA0C3B;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,GAAG,CAAC,EAAE,MAAM,EACZ,GAAG,SAAsB,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAoC3B;AACD,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB"}

package/dist/unified-functions.js

@@ -17,14 +17,15 @@ export function assertFunctionResults(data, expectedIds) {
     const seen = new Set();
     const deletedFunctionIds = [];
     for (const item of data.results) {
+        const requested = expected.has(item?.functionId);
         if (!item ||
             typeof item.functionId !== 'string' ||
             !Number.isSafeInteger(item.code) ||
             seen.has(item.functionId) ||
-            (!expected.has(item.functionId) && item.action !== 'delete'))
+            (requested ? item.action === 'delete' : item.action !== 'delete'))
             return unknown();
         seen.add(item.functionId);
-        if (item.action === 'delete')
+        if (!requested)
             deletedFunctionIds.push(item.functionId);
     }
     if (expectedIds.some((id) => !seen.has(id)))
@@ -34,17 +35,36 @@ export function assertFunctionResults(data, expectedIds) {
         throw new Error(`Function batch failed: ${JSON.stringify(failures)}`);
     return deletedFunctionIds;
 }
-export function putFunctions(token, kinds, functions, env, cwd) {
+export function putFunctions(options) {
     const data = responseData(runLarkCli([
         'api',
         'PUT',
-        `/open-apis/base/v3/sites/${encodeURIComponent(token)}/functions`,
+        `/open-apis/base/v3/sites/${encodeURIComponent(options.token)}/functions`,
         '--data',
-        JSON.stringify({ kinds, functions }),
-    ], env, cwd));
-    const deletedFunctionIds = assertFunctionResults(data, functions.map((item) => item.functionId));
+        JSON.stringify({
+            kinds: options.kinds,
+            functions: options.functions,
+        }),
+    ], options.env, options.cwd));
+    const deletedFunctionIds = assertFunctionResults(data, options.functions.map((item) => item.functionId));
     return { ...data, deletedFunctionIds };
 }
+export function validateFunctions(options) {
+    const data = responseData(runLarkCli([
+        'api',
+        'POST',
+        `/open-apis/base/v3/sites/${encodeURIComponent(options.token)}/functions/validate`,
+        '--data',
+        JSON.stringify({
+            kinds: options.kinds,
+            functions: options.functions,
+        }),
+    ], options.env, options.cwd));
+    assertFunctionResults(data, options.functions.map((item) => item.functionId));
+    if (data.valid !== true)
+        throw new Error('Function validation failed without item diagnostics');
+    return data;
+}
 export function functionPage(data, state, logId, cli = 'base-database-cli') {
     if (data.apiVersion !== 2)
         throw new LarkCliError({

package/dist/unified-functions.js.map

@@ -1 +1 @@
-{"version":3,"file":"unified-functions.js","sourceRoot":"","sources":["../src/unified-functions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"unified-functions.js","sourceRoot":"","sources":["../src/unified-functions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAkBzD,MAAM,UAAU,WAAW,CAAC,KAAK,GAAW,SAAS;IACnD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,MAAM;QACzC,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,OAAO,KAAK,CAAC;AACf,CAAC;AACD,MAAM,UAAU,qBAAqB,CACnC,IAA6B,EAC7B,WAA8B;IAE9B,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,MAAM,IAAI,KAAK,CACb,gIAAgI,CACjI,CAAC;IACJ,CAAC,CAAC;IACF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,EAAE,CAAC;IACnD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;IACtC,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,CAAC,MAAM;QAAE,OAAO,OAAO,EAAE,CAAC;IAC3D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,kBAAkB,GAAa,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACjD,IACE,CAAC,IAAI;YACL,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ;YACnC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;YAChC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC;YACzB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC;YAEjE,OAAO,OAAO,EAAE,CAAC;QACnB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1B,IAAI,CAAC,SAAS;YAAE,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAAE,OAAO,OAAO,EAAE,CAAC;IAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;IAChE,IAAI,QAAQ,CAAC,MAAM;QACjB,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxE,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AACD,MAAM,UAAU,YAAY,CAC1B,OAA4B;IAE5B,MAAM,IAAI,GAAG,YAAY,CACvB,UAAU,CACR;QACE,KAAK;QACL,KAAK;QACL,4BAA4B,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY;QACzE,QAAQ;QACR,IAAI,CAAC,SAAS,CAAC;YACb,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC;KACH,EACD,OAAO,CAAC,GAAG,EACX,OAAO,CAAC,GAAG,CACZ,CACF,CAAC;IACF,MAAM,kBAAkB,GAAG,qBAAqB,CAC9C,IAAI,EACJ,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CACjD,CAAC;IACF,OAAO,EAAE,GAAG,IAAI,EAAE,kBAAkB,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAiC;IAEjC,MAAM,IAAI,GAAG,YAAY,CACvB,UAAU,CACR;QACE,KAAK;QACL,MAAM;QACN,4BAA4B,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,qBAAqB;QAClF,QAAQ;QACR,IAAI,CAAC,SAAS,CAAC;YACb,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC;KACH,EACD,OAAO,CAAC,GAAG,EACX,OAAO,CAAC,GAAG,CACZ,CACF,CAAC;IACF,qBAAqB,CACnB,IAAI,EACJ,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CACjD,CAAC;IACF,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI;QACrB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,OAAO,IAAI,CAAC;AACd,CAAC;AAMD,MAAM,UAAU,YAAY,CAC1B,IAA6B,EAC7B,KAAwB,EACxB,KAAc,EACd,GAAG,GAAG,mBAAmB;IAEzB,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC;QACvB,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,8BAA8B;YACpC,OAAO,EAAE,uJAAuJ,GAAG,kDAAkD;YACrN,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5B,CAAC,CAAC;IACL,IACE,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI;QACpB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS;QACjC,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;QAClC,CAAC,CACC,CAAC,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;YACjC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvC,CAAC,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CACrE;QAED,MAAM,IAAI,KAAK,CACb,0FAA0F,CAC3F,CAAC;IACJ,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAClE,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ;QAC7D,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAC;IACJ,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAClC,IACE,CAAC,IAAI;YACL,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ;YACnC,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;YAC9C,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC;YAC9D,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC;YAE9B,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;QACJ,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,KAAa,EACb,OAAe,EACf,GAAsB,EACtB,GAAY,EACZ,GAAG,GAAG,mBAAmB;IAEzB,MAAM,SAAS,GAA8B,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,MAAM,KAAK,GAAsB,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;IAC9D,GAAG,CAAC;QACF,MAAM,QAAQ,GAAG,UAAU,CACzB;YACE,KAAK;YACL,KAAK;YACL,4BAA4B,kBAAkB,CAAC,KAAK,CAAC,YAAY;YACjE,UAAU;YACV,IAAI,CAAC,SAAS,CAAC;gBACb,UAAU,EAAE,CAAC;gBACb,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC;gBACzB,eAAe,EAAE,IAAI;gBACrB,QAAQ,EAAE,EAAE;gBACZ,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpC,CAAC;SACH,EACD,GAAG,EACH,GAAG,CACJ,CAAC;QACF,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACvE,SAAS,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QACpC,IACE,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;YAClC,CAAC,IAAI,CAAC,SAAS;YACf,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;YAExB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtB,CAAC,QAAQ,IAAI,EAAE;AACjB,CAAC;AACD,MAAM,UAAU,WAAW,CACzB,KAAa,EACb,GAAW,EACX,OAAe,EACf,GAAsB,EACtB,GAAY;IAEZ,MAAM,IAAI,GAAG,YAAY,CACvB,UAAU,CACR;QACE,KAAK;QACL,KAAK;QACL,4BAA4B,kBAAkB,CAAC,KAAK,CAAC,cAAc,kBAAkB,CAAC,GAAG,CAAC,EAAE;QAC5F,UAAU;QACV,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;KACrE,EACD,GAAG,EACH,GAAG,CACJ,CACF,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ;QACrD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,OAAO,IAAI,CAAC,QAAmC,CAAC;AAClD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-base-open/base-database-cli",
-  "version": "1.4.6",
+  "version": "1.4.9",
   "description": "CLI and Agent Skill for building database applications on Lark Base.",
   "type": "module",
   "bin": {

package/skills/lark-base-database/SKILL.md

@@ -11,7 +11,7 @@ metadata:
 
 本 Skill 面向开发者 Agent，用于搭建、修改和发布应用；`skill install` 安装这份随 CLI 分发的开发者 Skill。让外部 Agent 使用某个已发布站点的业务功能时，使用 `agent-tools skill install` 安装该站点的 Skill，见[外部 Agent 工具策略](references/agent-tools.md#安装到本地-agent)。
 
-新建 init 仅生成 workspace；存量 classic 的 SDK 接入和工程迁移按[工程与环境](references/workspace.md)与[Page 开发](references/development.md)执行。工程迁移按[迁移指南](references/workspace-migration.md)由 coding agent 执行；`dev` 仅在用户选择时使用。
+新建 init 仅生成 workspace，并用空 `ai/` 根记录“已知没有 AI Function”的声明集；需求不涉及 AI 时不向其中添加 Function。存量 classic 的 SDK 接入和工程迁移按[工程与环境](references/workspace.md)与[Page 开发](references/development.md)执行。工程迁移按[迁移指南](references/workspace-migration.md)由 coding agent 执行；`dev` 仅在用户选择时使用。
 
 账号选择遵守[工程与环境的 profile 约定](references/workspace.md#账号选择)；直接调用原生 lark-cli 时也使用同一个 profile。
 `lark-cli` 的账号管理和文档命令按环境提供，不是所有宿主的必备能力；首次选择入口及缺少命令时按[环境与依赖](references/workspace.md#环境与依赖)处理。
@@ -37,7 +37,7 @@ metadata:
 
 ## 开发阶段路由
 
-新增或修改 Database Function、Mutation、FaaS 时，先按[面向 Agent 的函数与参数设计](references/agent-tool-design.md)写函数说明和参数声明（`name`、`description`、可选 `enum`），使[外部 Agent](#术语) 能选对函数并填对参数；按[外部 Agent 工具策略](references/agent-tools.md)确定需要排除的内部函数。
+新增或修改 Database Function、Mutation、FaaS、AI Function 时，先按[面向 Agent 的函数与参数设计](references/agent-tool-design.md)写函数说明和参数声明（`name`、`description`、可选 `enum`），使[外部 Agent](#术语) 能选对函数并填对参数；按[外部 Agent 工具策略](references/agent-tools.md)确定需要排除的内部函数。
 
 | 需要完成的工作                                        | 必读协议                                                                                |
 | ----------------------------------------------------- | --------------------------------------------------------------------------------------- |
@@ -63,7 +63,7 @@ metadata:
 
 新建或整体改版先在内部规划中确定视觉方案，再实现设计变量和组件。业务建模与通用工程取舍按[工程质量](references/style-guide.md)执行；默认不创建额外设计文件。新建站点或修改业务能力时，按[站点 README](references/release.md#站点-readme)维护随源码制品上传的项目说明；用户要求其他文档时按要求交付。
 
-恢复已有 AI Function 时先读[恢复协议](references/ai-function.md#恢复已有-ai-function)，配置与调用按[AI Function](references/ai-function.md)执行。AI 与其他函数的发布顺序、skip 行为、显式 sync 的删除边界及失败恢复统一见[发布参考](references/release.md#function-发布顺序与错误边界)。
+恢复远端工程统一按[工程与环境](references/workspace.md#先选择工程来源)执行 `pull`；各类 Function 的发布与失败恢复统一见[发布参考](references/release.md#function-发布顺序与错误边界)。
 
 ## 关键约束
 
@@ -71,9 +71,9 @@ metadata:
 2. Base 是业务数据事实源，`catalog.json` 是已绑定表的 schema 事实源。表、字段、ID、类型、选项和关系来自真实结果，不由名称或建模输入猜测。
 3. **权限边界**：应用以 owner 身份访问 Base。访问者通过已发布 Function 使用业务能力；浏览器直接记录 CRUD 已关闭，固定写入由 Mutation 声明约束。FaaS 通过[固定记录写入路由](references/faas.md#应用记录写入协议)写入，不受 Mutation 声明约束，须在 FaaS 内校验输入与调用者身份。读取身份通过 Database Function 中的 `CURRENT_USER_ID()` 获取，Mutation 使用服务端 `current_user`。自定义角色和统一行列权限尚未接入。绑定与权限设计必须遵守[权限边界](references/permission-design.md)。
 4. Page 读取走 Database Function；普通单表创建、按记录 ID 更新和删除（含批量及附件写入）优先使用 Mutation；需要声明之外的服务端业务校验、计算或编排时使用 FaaS，边界见[写入方式选择](references/mutations.md#写入方式选择)。Database Function 必须引用至少一个已绑定 Catalog 真实表；纯常量与无表依赖计算按[SQL 外实现放在哪](references/database-function-limitations.md#sql-外实现放在哪)选择位置。SQL 无法表达的计算，不得把查看者无权看到的明细发给 Page 处理，拿不准时放 FaaS。输入只能进入声明的业务参数，不能决定查询语句、URL、method、Base token、table ID、字段名、Function ID 或凭证。
-5. Database Function、Mutation 与 FaaS 的参数、返回值不同。Page 使用 `invokeDatabaseFunction<TData>`，`TData` 只描述顶层 `data`，不二次解包；协议见[Page 开发](references/development.md#function-调用契约)。部分成功与重试按 [Mutation 结果](references/mutations.md#调用与结果)或 [FaaS 记录协议](references/faas.md#应用记录写入协议)处理。
-6. AI 对话、生成、分类、总结、文生图或文生视频，使用 Page 侧 AI Function，不建 FaaS 模型代理、不直连模型域名。AI 是按需能力：需求不涉及时不创建 `ai/`、不调用 `ai-functions` 命令，也不提示用户开通。详见 [AI Function](references/ai-function.md)。
-7. 修改保留需求外源码、Base schema、metadata、bindings 和 Function。Functions 更新为全量覆盖，不能以只提交本次新增 Function 的方式更新已有应用。
+5. Database Function、Mutation、FaaS 与 AI Function 的参数、返回值不同。Page SDK API 以工程已安装版本的包内 docs 和示例为准；修改已有工程先按[SDK 版本与升级](references/development.md#工程迁移与-sdk-升级)核对 CLI 诊断。AI 按能力判定文本或媒体任务结果。统一调用与输出分层见[Page 开发](references/development.md#function-调用契约)，部分成功与重试按 [Mutation 结果](references/mutations.md#调用与结果)、[FaaS 记录协议](references/faas.md#应用记录写入协议)或[AI 调用入口](references/ai-function.md#能力与调用入口)处理。
+6. AI 对话、生成、分类、总结、文生图或文生视频，使用 Page 侧 AI Function，不建 FaaS 模型代理、不直连模型域名。AI 是按需能力：需求不涉及时不创建 AI Function。AI 写入被 feature gate 拒绝时默认发布失败；只有用户明确接受本次不对齐远端 AI Function 后才能使用 `deploy --skip-ai-functions`，不得自动追加参数重试。模型参数、页面调用与失败边界见[AI Function](references/ai-function.md)。
+7. 修改保留需求外源码、Base schema、metadata、bindings 和 Function。各类 Function 都以本地项目声明作为完整事实源；新增、修改和删除先体现在对应本地目录，再由普通 Preview deploy 全量覆盖远端草稿。AI 的 `ai/` 根存在时才表示本地声明集：空根是明确空集合；旧工程缺少整个根时 check/deploy 保留远端 AI 并提示先用公共 `pull` 恢复，不能把缺失根解释成删除授权。
 8. 保留 starter 的 ready 上报及宿主组件接入。附件能力取决于目标环境的父页面、所选写入方式和服务端协议；按[文件传输](references/file-transfer.md)实现，不以模拟成功代替真实能力。
 9. 第三方 npm 依赖必须使用目标应用的服务端依赖策略判断；普通 registry 版本默认可用，受限来源只有被 `allowedValues` 中某条正则完整匹配时可用。详见[第三方依赖策略](references/development.md#第三方依赖策略)。
 10. **交付边界**：常规发布先 Preview。新建 Base 的示例记录必须写入真实 Base，并用页面实际调用的 Database Function 回读；不以静态 fixture、`localStorage` 或页面自动播种代替。之后完成相关通知配置再交付。完整顺序只在[发布与交付](references/release.md)维护。

package/skills/lark-base-database/references/agent-tool-design.md

@@ -1,6 +1,6 @@
 # 面向 Agent 的函数与参数设计
 
-写或修改 Database Function、Mutation、FaaS 的函数说明和参数声明前读取本文；`check` 或 `deploy` 返回 `functionHints` 时回到本文自查。执行、权限与返回协议仍以 [Database Function](database-function.md)、[Mutation](mutations.md)、[FaaS](faas.md) 为准。
+写或修改 Database Function、Mutation、FaaS、AI Function 的函数说明和参数声明前读取本文；`check` 或 `deploy` 返回 `functionHints` 时回到本文自查。执行、权限与返回协议仍以 [Database Function](database-function.md)、[Mutation](mutations.md)、[FaaS](faas.md)、[AI Function](ai-function.md) 为准。
 
 [外部 Agent](../SKILL.md#术语) 看不到页面源码，只根据函数 `name`、`description` 和服务端按参数声明生成的 `inputSchema`、`parameters[]` 选择函数并填写参数。目标是调用者一次选对函数、一次填对参数。
 

package/skills/lark-base-database/references/agent-tools.md

@@ -29,7 +29,7 @@
 
 执行 `base-database-cli check` 校验声明，在 `agentTools.tools` 与 `agentTools.exclude` 中核对本地计划。准备跳过 AI 同步时，先执行 `base-database-cli check --skip-ai-functions`，再执行 `base-database-cli deploy --skip-ai-functions`：本地 AI ID 仍合法，但本次本地计划不包含这些 AI 的排除项，也不将其列入本地开放清单；两条命令均提示“AI Function 本次未同步，相关 agent-tools 配置未生效”。本地文件保留原声明，后续正常同步 AI 时排除项重新生效。跳过 AI 不解析其配置内容。
 
-远端已有 AI 仍按既有保留规则处理：策略接口整体替换 exclude，为避免意外重新开放函数，部署会查询远端 AI 清单，并继续提交其中已有 AI 的本地排除项；只有远端尚不存在的 AI 排除项被省略。该查询失败时继续沿用停止部署的规则，不猜测远端状态。本地计划不代表已发布开放清单。正式版开放能力按[调用站点函数](#调用站点函数)读取实时清单；Prod 继续提升 Preview 快照，不重新读取本地策略。
+未同步 AI 时，deploy 在同份草稿基线上保留远端 AI 的现有排除项；SQL、Mutation、FaaS 仍应用本地策略。跳过的本地 AI 排除项不修改远端 AI 的开放状态。本地计划不代表已发布开放清单。正式版开放能力按[调用站点函数](#调用站点函数)读取实时清单；Prod 提升已确认 Preview，不重新读取本地策略。
 
 业务能力说明与安装引导统一按[交付结果](release.md#交付结果)。
 
@@ -37,11 +37,9 @@
 
 ## 发布
 
-声明随 `site.zip` 保存，`pull` 恢复，并计入 Preview 制品的输入指纹；修改后须重新发布 Preview，再按原有流程确认 Prod。Preview 部署在更新函数后写入草稿开放策略，随后上传制品；Prod 提升已校验的 Preview 制品，不读取本地声明。
+声明随 `site.zip` 保存，`pull` 恢复，并计入 Preview 制品的输入指纹。Preview 将 Function、工具策略、源码及新增绑定一次原子提交；策略校验失败或基线冲突时整次拒绝。修改后须重新发布 Preview，再按原有流程确认 Prod；Prod 不读取本地声明。
 
-策略写入失败会停止部署。旧服务端明确不支持该接口时，文件缺席且没有 exclude 的工程可继续部署并保留远端原策略；存在文件时需升级服务端或移除文件。
-
-策略写入与源码上传不是原子操作。中途失败时，草稿策略与远端源码包可能暂不一致；保留本地工程并核对失败阶段，不盲目重试结果未知的写入。此时从旧源码包 `pull` 后直接部署，可能把排除清单恢复为空，应先恢复预期声明再重新部署。
+缺基线、冲突或写入结果未知时，按[远端更新与冲突恢复](workspace.md#远端更新与冲突恢复)处理，不回退逐接口写入。
 
 ## 调用站点函数
 
@@ -59,7 +57,7 @@
 
 判定与默认路径：
 
-- 调用前读取该函数的最新说明，按 `inputSchema` 构造 `{"params":{…}}`，参数按 `name` 传对象，不按位置传数组。`requestExample` 中 `replacePaths` 指向的值是占位，替换为真实值后再调用，不把示例 ID 当成真实记录。
+- 调用前读取该函数的最新说明。`requestExample` 是完整请求体模板；复制后按 `replacePaths` 替换占位值，不把示例 ID 当成真实记录，也不删除模板中的其他顶层字段。`inputSchema` 只描述 `requestExample.params`，参数按 `name` 传对象，不按位置传数组；Database Function、Mutation 与 FaaS 通常只需要 `params`，AI text/vision 还需要 `messages`，AI image/video 还需要 `input`。调用 AI Function 时必须保留 `messages` 或 `input`，不能只发送 `{"params":{…}}`。
 - `parameters[]` 中的 `reference` 表示参数是某张表的记录 ID，`valueHint` 是作者写的取值步骤，`optionSummary` 是有界的选项提示而非完整选项集合；取值按作者说明先调用相应只读函数，不从字段名或表名猜测调用顺序。
 - 写入类函数每次调用前重新读取说明；同一身份、站点、环境和版本下紧邻的只读调用可复用刚读到的说明，调用失败或说明变化后重新读取。