@lark-base-open/base-database-cli 1.4.3 → 1.4.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +24 -1
- package/README.md +5 -8
- package/dist/agent-tools-guide.d.ts +1 -0
- package/dist/agent-tools-guide.d.ts.map +1 -1
- package/dist/agent-tools-guide.js +5 -2
- package/dist/agent-tools-guide.js.map +1 -1
- package/dist/agent-tools-skill.d.ts.map +1 -1
- package/dist/agent-tools-skill.js +34 -8
- package/dist/agent-tools-skill.js.map +1 -1
- package/dist/ai-functions.d.ts.map +1 -1
- package/dist/ai-functions.js +1 -1
- package/dist/ai-functions.js.map +1 -1
- package/dist/contract-extractor.d.ts +6 -2
- package/dist/contract-extractor.d.ts.map +1 -1
- package/dist/contract-extractor.js +135 -152
- package/dist/contract-extractor.js.map +1 -1
- package/dist/deploy.d.ts +1 -1
- package/dist/deploy.d.ts.map +1 -1
- package/dist/deploy.js +4 -2
- package/dist/deploy.js.map +1 -1
- package/dist/function-contracts.d.ts.map +1 -1
- package/dist/function-contracts.js +4 -22
- package/dist/function-contracts.js.map +1 -1
- package/dist/lark-cli.d.ts.map +1 -1
- package/dist/lark-cli.js +7 -1
- package/dist/lark-cli.js.map +1 -1
- package/dist/program.js +3 -3
- package/dist/program.js.map +1 -1
- package/dist/project-context.d.ts +3 -3
- package/dist/project-context.d.ts.map +1 -1
- package/dist/project-context.js +8 -16
- package/dist/project-context.js.map +1 -1
- package/dist/unified-functions.d.ts +2 -2
- package/dist/unified-functions.d.ts.map +1 -1
- package/dist/unified-functions.js +16 -7
- package/dist/unified-functions.js.map +1 -1
- package/package.json +1 -1
- package/skills/lark-base-database/references/agent-tools.md +5 -3
- package/skills/lark-base-database/references/release.md +1 -1
- package/dist/contract-worker.d.ts +0 -12
- package/dist/contract-worker.d.ts.map +0 -1
- package/dist/contract-worker.js +0 -90
- package/dist/contract-worker.js.map +0 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"unified-functions.js","sourceRoot":"","sources":["../src/unified-functions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAUzD,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,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,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC;YAE5D,OAAO,OAAO,EAAE,CAAC;QACnB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1B,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ;YAAE,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzE,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,KAAa,EACb,KAAqB,EACrB,SAA0B,EAC1B,GAAsB,EACtB,GAAY;IAEZ,MAAM,IAAI,GAAG,YAAY,CACvB,UAAU,CACR;QACE,KAAK;QACL,KAAK;QACL,4BAA4B,kBAAkB,CAAC,KAAK,CAAC,YAAY;QACjE,QAAQ;QACR,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;KACrC,EACD,GAAG,EACH,GAAG,CACJ,CACF,CAAC;IACF,MAAM,kBAAkB,GAAG,qBAAqB,CAC9C,IAAI,EACJ,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CACzC,CAAC;IACF,OAAO,EAAE,GAAG,IAAI,EAAE,kBAAkB,EAAE,CAAC;AACzC,CAAC;AAMD,MAAM,UAAU,YAAY,CAC1B,IAA6B,EAC7B,KAAwB;
|
|
1
|
+
{"version":3,"file":"unified-functions.js","sourceRoot":"","sources":["../src/unified-functions.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
|
|
30
30
|
执行 `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 不解析其配置内容。
|
|
31
31
|
|
|
32
|
-
远端已有 AI 仍按既有保留规则处理:策略接口整体替换 exclude,为避免意外重新开放函数,部署会查询远端 AI 清单,并继续提交其中已有 AI 的本地排除项;只有远端尚不存在的 AI
|
|
32
|
+
远端已有 AI 仍按既有保留规则处理:策略接口整体替换 exclude,为避免意外重新开放函数,部署会查询远端 AI 清单,并继续提交其中已有 AI 的本地排除项;只有远端尚不存在的 AI 排除项被省略。该查询失败时继续沿用停止部署的规则,不猜测远端状态。本地计划不代表已发布开放清单。正式版开放能力按[调用站点函数](#调用站点函数)读取实时清单;Prod 继续提升 Preview 快照,不重新读取本地策略。
|
|
33
33
|
|
|
34
34
|
业务能力说明与安装引导统一按[交付结果](release.md#交付结果)。
|
|
35
35
|
|
|
@@ -49,10 +49,12 @@
|
|
|
49
49
|
|
|
50
50
|
| 步骤 | 命令 | 读取 |
|
|
51
51
|
| --- | --- | --- |
|
|
52
|
-
| 发现 | `lark-cli api GET /open-apis/base/v3/sites/<app-token>/functions --params '{"env":"prod"}' --as user` | `functions[]` 的 `name`、`description`、`functionType`、`schemaStatus`、`statusHint`;`hasMore` 为 true 时带 `pageToken` 继续 |
|
|
52
|
+
| 发现 | `lark-cli api GET /open-apis/base/v3/sites/<app-token>/functions --params '{"apiVersion":2,"env":"prod"}' --as user` | `functions[]` 的 `name`、`description`、`functionType`、`schemaStatus`、`statusHint`;`hasMore` 为 true 时带 `pageToken` 继续 |
|
|
53
53
|
| 说明 | `lark-cli api GET /open-apis/base/v3/sites/<app-token>/functions/<function-id> --params '{"env":"prod"}' --as user` | `data.function` 的 `inputSchema`、`parameters[]`、`requestExample`、`replacePaths`、`callCommand`;Mutation 还读取 `outputSchema` 了解返回字段名称和类型 |
|
|
54
54
|
| 调用 | 按 `callCommand`:`lark-cli api POST /open-apis/base/v3/sites/<app-token>/functions/<function-id>/invoke --params '{"env":"prod"}' --data @body.json --as user` | 顶层业务码与 `data` |
|
|
55
55
|
|
|
56
|
+
列表请求始终携带 `apiVersion=2`,包括翻页、`env=preview` 或 `includeInternal=true`;检查响应 `data.apiVersion` 为数字 `2` 后再使用列表,未回写 `2` 时,通过同站点的 `skillCommand`(`GET /open-apis/base/v3/sites/<app-token>/skill`)读取 SKILL.md 清单,逐个读取函数的实时说明后再调用,不把该列表响应视为空清单。
|
|
57
|
+
|
|
56
58
|
原则:参数以服务端实时返回的说明为准,Skill、函数索引和历史会话不保存参数 Schema。仅站点管理者做开发期验证时可在列表、说明和调用的 `--params` 中显式加 `"includeInternal":true` 访问页面专用内部函数;外部 Agent 默认不带。
|
|
57
59
|
|
|
58
60
|
判定与默认路径:
|
|
@@ -98,4 +100,4 @@ Prod 成员安装命令由 CLI 交付块生成。完整交付条件与回复写
|
|
|
98
100
|
|
|
99
101
|
默认安装到 Codex;`--target codex|agents|claude|all` 与 `--dir <path>` 的目标目录语义同 `skill install`,`--dir` 指定 skills 根目录。站点更新后,成员重复执行 `--site` 安装命令即可更新同一站点已记录的安装;未被摘要识别的目录仍需核对目标,并在用户授权下使用 `--force`。工程安装(不带 `--site`)如目标目录已存在,无论是否保存过摘要,都须先核对目标,并在用户授权下加 `--force` 重新安装。
|
|
100
102
|
|
|
101
|
-
|
|
103
|
+
安装成功后,按[调用站点函数](#调用站点函数)分页读取实时列表,确认 `data.apiVersion=2`,只从 `agentTool=true` 的函数中选一个真实只读函数,读取其最新说明后实际调用并核对业务结果;仅列表未回写 `2` 时改从同站点 Skill 清单选择,再读取实时说明和调用。无可用只读函数则说明自检未完成,不用写入或 AI 函数代替。本地文件写入、客户端发现、远端调用分别报告实际验证结果。
|
|
@@ -122,7 +122,7 @@ Prod 发布不会自动更新 Base workflow。存在通知集成时,按 Previe
|
|
|
122
122
|
1. **状态与入口**:说明是 Preview 还是已获授权的 Prod,以及完成、部分完成或阻塞状态。访问链接只使用本次成功发布的 CLI 返回的 `baseAppUrl`;发布未成功或入口缺失时不猜测链接。`staticUrl` 和制品地址仅用于内部预览与追溯。
|
|
123
123
|
2. **业务结果与体验**:列出本次实现的功能或变更,以及用户可直接执行的体验步骤。新建 Base 的示例数据说明覆盖的业务对象和页面 Database Function 回读结果;复用或修改已有应用时不声称添加了示例数据。
|
|
124
124
|
3. **验证与待处理项**:逐项说明实际通过的检查及其范围;未执行的页面交互、角色权限或生产验证标为未验证。失败、结果未知、通知未完成时,给出具体影响和下一步,不把 Preview 发布成功等同于整个任务完成。
|
|
125
|
-
4. **本地 Agent 的业务用法**:Prod 发布后,按 `nextAction.externalAgent.
|
|
125
|
+
4. **本地 Agent 的业务用法**:Prod 发布后,按 `nextAction.externalAgent.functionsCommand` 分页读取实时列表,逐页确认 `data.apiVersion=2`,仅将 `agentTool=true` 函数的 `name`/`description` 转成业务语言写入“可用能力”。仅列表未回写 `2` 时按 `skillCommand` 读取同站点 SKILL.md 清单兜底;不从本地源码臆测。将 `nextAction.externalAgent.handoff.markdown` 完整原样附上,保留全部文字、换行和 Markdown 格式;不改写或删节。所选清单读取失败时说明情况并省略能力清单,不影响发布成功;`installation.available` 只决定安装引导是否可用,不阻断实时列表发现。Preview 交付只附引导,说明正式版发布后外部 Agent 才能安装使用。后续追问可简短回答或指向已给出的交付内容。本地安装或 Prod 发布仍遵循各自授权条件,不因展示交付块而自动执行。
|
|
126
126
|
|
|
127
127
|
命令、Function ID、制品摘要和 workflow 清单保留为可追溯证据,按研发或排障需要展示,不要求业务用户检查 header 或 SDK 协议。
|
|
128
128
|
|
|
@@ -1,12 +0,0 @@
|
|
|
1
|
-
import type { ContractEntry } from './contract-extractor.js';
|
|
2
|
-
export interface ConvertedContract {
|
|
3
|
-
input?: Record<string, unknown>;
|
|
4
|
-
output?: Record<string, unknown>;
|
|
5
|
-
warnings: string[];
|
|
6
|
-
}
|
|
7
|
-
export { validateFullSchema } from './app-builder/schema.js';
|
|
8
|
-
/** Only a validated Schema-only graph reaches this subprocess. This is not an arbitrary-code sandbox. */
|
|
9
|
-
export declare function convertContract(entry: ContractEntry): Promise<ConvertedContract>;
|
|
10
|
-
/** Read-only context uses the same isolated extraction without an async API. */
|
|
11
|
-
export declare function convertContractSync(entry: ContractEntry): ConvertedContract;
|
|
12
|
-
//# sourceMappingURL=contract-worker.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"contract-worker.d.ts","sourceRoot":"","sources":["../src/contract-worker.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AACD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,yGAAyG;AACzG,wBAAsB,eAAe,CACnC,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAE5B;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,iBAAiB,CAoF3E"}
|
package/dist/contract-worker.js
DELETED
|
@@ -1,90 +0,0 @@
|
|
|
1
|
-
import { validateFullSchema } from './app-builder/schema.js';
|
|
2
|
-
import { execFileSync } from 'node:child_process';
|
|
3
|
-
import { mkdtempSync, rmSync, writeFileSync, realpathSync } from 'node:fs';
|
|
4
|
-
import { tmpdir } from 'node:os';
|
|
5
|
-
import { join, relative } from 'node:path';
|
|
6
|
-
import { buildSync } from 'esbuild';
|
|
7
|
-
export { validateFullSchema } from './app-builder/schema.js';
|
|
8
|
-
/** Only a validated Schema-only graph reaches this subprocess. This is not an arbitrary-code sandbox. */
|
|
9
|
-
export async function convertContract(entry) {
|
|
10
|
-
return convertContractSync(entry);
|
|
11
|
-
}
|
|
12
|
-
/** Read-only context uses the same isolated extraction without an async API. */
|
|
13
|
-
export function convertContractSync(entry) {
|
|
14
|
-
if (Number(process.versions.node.split('.')[0]) < 22)
|
|
15
|
-
throw new Error('CONTRACT_WORKER_NODE22_REQUIRED');
|
|
16
|
-
const temp = mkdtempSync(join(tmpdir(), 'base-contract-'));
|
|
17
|
-
try {
|
|
18
|
-
const bundle = join(temp, 'schema.cjs');
|
|
19
|
-
const built = buildSync({
|
|
20
|
-
stdin: {
|
|
21
|
-
contents: `export { ${entry.input} as input, ${entry.output} as output } from ${JSON.stringify(entry.entry)};`,
|
|
22
|
-
resolveDir: temp,
|
|
23
|
-
loader: 'ts',
|
|
24
|
-
},
|
|
25
|
-
bundle: true,
|
|
26
|
-
platform: 'node',
|
|
27
|
-
format: 'cjs',
|
|
28
|
-
outfile: bundle,
|
|
29
|
-
write: false,
|
|
30
|
-
metafile: true,
|
|
31
|
-
logLevel: 'silent',
|
|
32
|
-
});
|
|
33
|
-
for (const path of Object.keys(built.metafile.inputs)) {
|
|
34
|
-
if (path === '<stdin>')
|
|
35
|
-
continue;
|
|
36
|
-
const real = realpathSync(path);
|
|
37
|
-
const pkgRelative = relative(entry.schemaPackageRoot, real);
|
|
38
|
-
if (!entry.files.includes(real) &&
|
|
39
|
-
(pkgRelative.startsWith('..') || pkgRelative.startsWith('/')))
|
|
40
|
-
throw new Error('CONTRACT_UNAPPROVED_DEPENDENCY');
|
|
41
|
-
}
|
|
42
|
-
writeFileSync(bundle, built.outputFiles[0].contents);
|
|
43
|
-
const worker = join(temp, 'worker.cjs');
|
|
44
|
-
writeFileSync(worker, `
|
|
45
|
-
'use strict';
|
|
46
|
-
globalThis.fetch = () => { throw new Error('NETWORK_DISABLED'); };
|
|
47
|
-
globalThis.WebSocket = undefined;
|
|
48
|
-
const schemas = require('./schema.cjs');
|
|
49
|
-
const result = {warnings: []};
|
|
50
|
-
for (const direction of ['input', 'output']) {
|
|
51
|
-
try {
|
|
52
|
-
const standard = schemas[direction]?.['~standard'];
|
|
53
|
-
if (standard?.version !== 1 || typeof standard.jsonSchema?.[direction] !== 'function') throw new Error();
|
|
54
|
-
result[direction] = standard.jsonSchema[direction]({target:'draft-2020-12'});
|
|
55
|
-
if (result[direction]?.then) throw new Error();
|
|
56
|
-
} catch { delete result[direction]; result.warnings.push('CONTRACT_' + direction.toUpperCase() + '_RUNTIME_ONLY'); }
|
|
57
|
-
}
|
|
58
|
-
process.stdout.write(JSON.stringify(result));
|
|
59
|
-
`);
|
|
60
|
-
const stdout = execFileSync(process.execPath, [
|
|
61
|
-
'--experimental-permission',
|
|
62
|
-
`--allow-fs-read=${temp}`,
|
|
63
|
-
'--max-old-space-size=128',
|
|
64
|
-
worker,
|
|
65
|
-
], {
|
|
66
|
-
cwd: temp,
|
|
67
|
-
env: {},
|
|
68
|
-
encoding: 'utf8',
|
|
69
|
-
timeout: 5000,
|
|
70
|
-
maxBuffer: 256 * 1024,
|
|
71
|
-
stdio: ['ignore', 'pipe', 'pipe'],
|
|
72
|
-
});
|
|
73
|
-
const result = JSON.parse(stdout);
|
|
74
|
-
for (const direction of ['input', 'output'])
|
|
75
|
-
if (result[direction]) {
|
|
76
|
-
try {
|
|
77
|
-
validateFullSchema(result[direction]);
|
|
78
|
-
}
|
|
79
|
-
catch (error) {
|
|
80
|
-
delete result[direction];
|
|
81
|
-
result.warnings.push(`CONTRACT_${direction.toUpperCase()}_SCHEMA_UNSUPPORTED:${error instanceof Error && /^CONTRACT_[A-Z_]+$/.test(error.message) ? error.message : 'CONTRACT_SCHEMA_UNSUPPORTED'}`);
|
|
82
|
-
}
|
|
83
|
-
}
|
|
84
|
-
return result;
|
|
85
|
-
}
|
|
86
|
-
finally {
|
|
87
|
-
rmSync(temp, { recursive: true, force: true });
|
|
88
|
-
}
|
|
89
|
-
}
|
|
90
|
-
//# sourceMappingURL=contract-worker.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"contract-worker.js","sourceRoot":"","sources":["../src/contract-worker.ts"],"names":[],"mappings":"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"}
|