@lark-base-open/base-database-cli 1.4.0 → 1.4.5

package/config-schema.json

@@ -3,7 +3,10 @@
   "title": "Base Database CLI configuration",
   "type": "object",
   "additionalProperties": false,
-  "required": ["configVersion", "appToken"],
+  "required": [
+    "configVersion",
+    "appToken"
+  ],
   "properties": {
     "$schema": {
       "type": "string"
@@ -29,6 +32,64 @@
       "type": "string",
       "minLength": 1
     },
-    "bindings": {}
-  }
+    "bindings": {},
+    "template": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name",
+        "version"
+      ],
+      "properties": {
+        "name": {
+          "const": "database-starter"
+        },
+        "version": {
+          "enum": [
+            1,
+            2
+          ]
+        }
+      },
+      "description": "Starter layout version. Omitted in legacy database-starter version 1 projects."
+    },
+    "managedAgentDocs": {
+      "type": "boolean",
+      "default": true,
+      "description": "Maintain the base-app managed section in AGENTS.md and the CLAUDE.md reference. Set false to opt out."
+    },
+    "functionInputs": {
+      "enum": [
+        "named",
+        "positional"
+      ],
+      "description": "Classic Page/helper input contract; defaults to positional when omitted. Workspace and SDK clients use named inputs."
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "required": [
+          "template"
+        ],
+        "properties": {
+          "template": {
+            "properties": {
+              "version": {
+                "const": 2
+              }
+            },
+            "type": "object"
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "functionInputs": {
+            "const": "named"
+          }
+        }
+      }
+    }
+  ]
 }

package/data/template-hmr-scripts.json

@@ -0,0 +1,9 @@
+{
+  "schemaVersion": 1,
+  "scripts": [
+    {
+      "sha256": "6e07b18ba1e30eca8bcaf3c99393e174d404d43e3f3ae31568d0075473d6bee2",
+      "code": "\n      if (import.meta.hot?.on) {\n        import.meta.hot.on('vite:error', (error) => {\n          if (error.err) {\n            console.error(\n              [error.err.message, error.err.frame].filter(Boolean).join('\\n'),\n            )\n          }\n        })\n      }\n    "
+    }
+  ]
+}

package/data/template-index-html/17e698eef687ece8f1628e3e2c4801da5e7233faa87076b3424acde8df57b825.html

@@ -0,0 +1,24 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/png" href="/favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title></title>
+    <script type="module">
+      if (import.meta.hot?.on) {
+        import.meta.hot.on('vite:error', (error) => {
+          if (error.err) {
+            console.error(
+              [error.err.message, error.err.frame].filter(Boolean).join('\n'),
+            )
+          }
+        })
+      }
+    </script>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/dist/agent-tools-guide.d.ts

@@ -0,0 +1,30 @@
+import type { RuntimeProfile } from './environment.js';
+export declare function recordSiteSkillInstallation(workspace: string, appToken: string, runtime: string, bundle: {
+    hash: string;
+    files: Record<string, string>;
+}, directories: string[]): void;
+export interface ExternalAgentGuide {
+    environment: 'preview' | 'prod';
+    installation: {
+        available: boolean;
+        message: string;
+        command: string;
+    };
+    skillCommand?: string;
+    functionsCommand?: string;
+    memberInstallation?: {
+        siteUrl: string;
+        command: string;
+        message: string;
+    };
+    handoff?: {
+        markdown: string;
+    };
+}
+/** Prod Skill availability is optional and must never fail a completed publication. */
+export declare function externalAgentGuide(workspace: string, appToken: string, runtime: RuntimeProfile, environment: 'preview' | 'prod', env: NodeJS.ProcessEnv, baseAppUrl?: string): ExternalAgentGuide;
+export declare function deploymentNextAction(workspace: string, appToken: string, runtime: RuntimeProfile, environment: 'preview' | 'prod', env: NodeJS.ProcessEnv, baseAppUrl?: string): {
+    delivery: string;
+    externalAgent: ExternalAgentGuide;
+};
+//# sourceMappingURL=agent-tools-guide.d.ts.map

package/dist/agent-tools-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools-guide.d.ts","sourceRoot":"","sources":["../src/agent-tools-guide.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAsCvD,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,EACvD,WAAW,EAAE,MAAM,EAAE,GACpB,IAAI,CA2BN;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,SAAS,GAAG,MAAM,CAAC;IAChC,YAAY,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,OAAO,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,SAAS,GAAG,MAAM,EAC/B,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,UAAU,CAAC,EAAE,MAAM,GAClB,kBAAkB,CAgHpB;AAsBD,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,SAAS,GAAG,MAAM,EAC/B,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,UAAU,CAAC,EAAE,MAAM;;;EA4BpB"}

package/dist/agent-tools-guide.js

@@ -0,0 +1,172 @@
+import { createHash } from 'node:crypto';
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { responseData, runLarkCli } from './lark-cli.js';
+import { LarkCliError, safeDiagnostic } from './lark-cli-error.js';
+const receiptPath = (workspace) => join(workspace, '.base-database-cli/state/agent-tools-skill.json');
+const digest = (content) => createHash('sha256').update(content).digest('hex');
+function readReceipt(workspace, appToken, runtime) {
+    try {
+        const receipt = JSON.parse(readFileSync(receiptPath(workspace), 'utf8'));
+        return receipt.appToken === appToken &&
+            receipt.runtime === runtime &&
+            Array.isArray(receipt.installations)
+            ? receipt.installations
+            : [];
+    }
+    catch {
+        return [];
+    }
+}
+// Keep server hash and exact installed bytes together; never infer an installation from its name.
+export function recordSiteSkillInstallation(workspace, appToken, runtime, bundle, directories) {
+    const installations = readReceipt(workspace, appToken, runtime).filter((item) => !directories.includes(item.directory));
+    const files = Object.fromEntries(Object.entries(bundle.files).map(([path, content]) => [
+        path,
+        digest(content),
+    ]));
+    installations.push(...directories.map((directory) => ({
+        directory,
+        hash: bundle.hash,
+        files,
+    })));
+    const path = receiptPath(workspace);
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify({ appToken, runtime, installations }, null, 2) + '\n');
+}
+/** Prod Skill availability is optional and must never fail a completed publication. */
+export function externalAgentGuide(workspace, appToken, runtime, environment, env, baseAppUrl) {
+    const cli = runtime.deployCommand.replace(/ deploy$/, '');
+    const command = `${cli} agent-tools skill install`;
+    const projectUpdate = '工程安装（不带 --site）如目标目录已存在，请先核对目标，在用户授权下加 --force 重新安装。';
+    if (environment === 'preview') {
+        return {
+            environment,
+            installation: {
+                available: false,
+                message: 'Preview 站点 Skill 当前不能安装；最终回复附上 handoff.markdown，其中说明正式版发布后可安装与分发。该步骤不授权 Prod 发布或调用。' +
+                    projectUpdate,
+                command,
+            },
+            handoff: {
+                markdown: `发布正式版后外部 Agent 才能安装使用并分发本站 Skill。开发者安装命令：\n\n\`${command}\`\n\n${projectUpdate}`,
+            },
+        };
+    }
+    const path = `/open-apis/base/v3/sites/${encodeURIComponent(appToken)}/skill`;
+    const skillCommand = `${cli} lark-cli -- api GET ${path} --as user`;
+    const functionsCommand = `${cli} lark-cli -- api GET /open-apis/base/v3/sites/${encodeURIComponent(appToken)}/functions --params '{"apiVersion":2,"env":"prod"}' --as user`;
+    try {
+        // Only confirm availability: do not parse SKILL.md or compare hashes.
+        runLarkCli(['api', 'GET', path], env, workspace);
+    }
+    catch (error) {
+        const logId = error instanceof LarkCliError ? error.details.logId : undefined;
+        const diagnostic = logId
+            ? ` (LogID: ${safeDiagnostic(logId, env).replace(/[\r\n\u2028\u2029]+/g, ' ')})`
+            : '';
+        process.stderr.write(`Warning: Publication succeeded, but the site Skill is temporarily unavailable${diagnostic}.\n`);
+        return {
+            environment,
+            installation: {
+                available: false,
+                message: '发布已成功，站点 Skill 暂不可获取；稍后通过 skillCommand 重试读取。' +
+                    projectUpdate,
+                command,
+            },
+            skillCommand,
+            functionsCommand,
+        };
+    }
+    const memberInstallation = baseAppUrl
+        ? {
+            siteUrl: baseAppUrl,
+            command: `${command} --site ${shellQuote(baseAppUrl)}`,
+            message: 'Prod 成员分发内容由 handoff.markdown 生成；最终回复原样附上该交付块。',
+        }
+        : undefined;
+    let publishedSiteName;
+    if (baseAppUrl) {
+        try {
+            const project = responseData(runLarkCli([
+                'api',
+                'GET',
+                `/open-apis/base/v3/sites/${encodeURIComponent(appToken)}/get`,
+                '--params',
+                JSON.stringify({ env: environment }),
+            ], env, workspace)).project;
+            if (project &&
+                typeof project === 'object' &&
+                'name' in project &&
+                typeof project.name === 'string' &&
+                project.name.trim())
+                publishedSiteName = project.name.trim();
+        }
+        catch {
+            // Site name is optional; never substitute a local directory name.
+        }
+    }
+    const handoff = [
+        `开发者：在包含 base-database.jsonc 的工程目录执行 \`${command}\`。需要我现在在工程目录执行，安装到当前用户的 Codex Skill 目录吗？${projectUpdate}`,
+        ...(memberInstallation
+            ? [
+                '',
+                '> 转发给团队成员',
+                publishedSiteName
+                    ? `> 站点：${markdownText(publishedSiteName)}（${markdownUrl(baseAppUrl)}）`
+                    : `> 站点链接：${markdownUrl(baseAppUrl)}`,
+                `> 安装命令：\`${memberInstallation.command}\``,
+                '> 能力随个人站点权限提供。站点更新后，成员重新执行上述 --site 安装命令即可更新同一站点已记录的安装。',
+            ]
+            : []),
+    ].join('\n');
+    return {
+        environment,
+        installation: {
+            available: true,
+            message: '最终回复附上 handoff.markdown；仅在用户同意后执行工程目录安装命令，不自动安装。' +
+                projectUpdate,
+            command,
+        },
+        skillCommand,
+        functionsCommand,
+        ...(memberInstallation ? { memberInstallation } : {}),
+        handoff: { markdown: handoff },
+    };
+}
+function markdownText(value) {
+    return value
+        .replace(/[\r\n\t\u2028\u2029]+/g, ' ')
+        .replace(/[\p{Cc}\p{Cf}]/gu, '')
+        .replace(/ +/g, ' ')
+        .trim()
+        .replace(/[\\`*_{}\[\]()#+\-.!|<>~&]/g, '\\$&');
+}
+function markdownUrl(value) {
+    return value
+        .replaceAll('\\', '\\\\')
+        .replaceAll('`', '\\`')
+        .replaceAll('|', '\\|');
+}
+function shellQuote(value) {
+    return `'${value.replaceAll("'", "'\\''")}'`;
+}
+export function deploymentNextAction(workspace, appToken, runtime, environment, env, baseAppUrl) {
+    const externalAgent = externalAgentGuide(workspace, appToken, runtime, environment, env, baseAppUrl);
+    const delivery = environment === 'preview'
+        ? 'Complete the agreed Preview sample-data readback and notification follow-up before sharing baseAppUrl for user review. Publishing to Prod requires confirmation for this same artifact. Preview publication does not authorize production Function calls.'
+        : 'Complete the agreed production verification and notification follow-up before sharing baseAppUrl.';
+    const capabilities = environment === 'prod'
+        ? ` Read the live function list using \`${externalAgent.functionsCommand}\` (externalAgent.functionsCommand). Require numeric data.apiVersion=2 on every page and follow hasMore/pageToken with the same parameters until all pages are read. Add “可用能力” in business language using only the name/description of functions with agentTool=true. Only if a successful list response does not report data.apiVersion=2, use \`${externalAgent.skillCommand}\` (externalAgent.skillCommand) to read the SKILL.md function list instead. Do not infer capabilities from local source. If the selected source cannot be read, report the failure and omit the capability list. installation.available controls only the Skill installation guide, not function discovery.`
+        : '';
+    return {
+        delivery: delivery +
+            capabilities +
+            (externalAgent.handoff
+                ? ' Include the complete externalAgent.handoff.markdown verbatim, preserving every line and Markdown format. Later follow-up replies may answer the question briefly or point to the delivery already provided.'
+                : ' State that publication succeeded but the site Skill is temporarily unavailable.') +
+            ' Do not install or publish Prod automatically; follow user authorization for either action.',
+        externalAgent,
+    };
+}
+//# sourceMappingURL=agent-tools-guide.js.map

package/dist/agent-tools-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools-guide.js","sourceRoot":"","sources":["../src/agent-tools-guide.ts"],"names":[],"mappings":"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"}

package/dist/agent-tools-skill.d.ts

@@ -0,0 +1,16 @@
+import { type RuntimeProfile } from './environment.js';
+import { type SkillInstallOptions } from './skill.js';
+interface SiteSkillBundle {
+    skillName: string;
+    hash: string;
+    files: Record<string, string>;
+}
+export declare function validateSiteSkillBundle(value: unknown): SiteSkillBundle;
+export declare function installAgentToolsSkill(options: SkillInstallOptions, runtime?: RuntimeProfile, site?: string, explicitProfile?: string): Promise<{
+    ok: boolean;
+    installed: string[];
+    skillName: string;
+    hash: string;
+}>;
+export {};
+//# sourceMappingURL=agent-tools-skill.d.ts.map

package/dist/agent-tools-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools-skill.d.ts","sourceRoot":"","sources":["../src/agent-tools-skill.ts"],"names":[],"mappings":"AAgBA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAM1B,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB,UAAU,eAAe;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAMD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CA8BvE;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,cAAuC,EAChD,IAAI,CAAC,EAAE,MAAM,EACb,eAAe,CAAC,EAAE,MAAM;;;;;GAgKzB"}

package/dist/agent-tools-skill.js

@@ -0,0 +1,209 @@
+import { LarkCliError, safeDiagnostic } from './lark-cli-error.js';
+import { skillFrontmatter } from './skill-frontmatter.js';
+import { recordSiteSkillInstallation } from './agent-tools-guide.js';
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync, } from 'node:fs';
+import { homedir, tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { readConfig } from './config.js';
+import { assertProjectRuntimeProfile, ONLINE_RUNTIME_PROFILE, } from './environment.js';
+import { responseData, resolveLarkProfileEnvironment, runLarkCli, } from './lark-cli.js';
+import { installSkillDirectory, skillDestinations, } from './skill.js';
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+export function validateSiteSkillBundle(value) {
+    if (!isRecord(value))
+        throw new Error('Invalid site Skill bundle');
+    const { skillName, hash, files } = value;
+    if (typeof skillName !== 'string' ||
+        skillName.length > 64 ||
+        !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(skillName))
+        throw new Error('Invalid site Skill bundle: illegal skillName');
+    if (typeof hash !== 'string' || hash.trim() === '')
+        throw new Error('Invalid site Skill bundle: hash is required');
+    if (!isRecord(files) || typeof files['SKILL.md'] !== 'string')
+        throw new Error('Invalid site Skill bundle: SKILL.md is required');
+    for (const [path, content] of Object.entries(files)) {
+        if (path !== 'SKILL.md' &&
+            !/^references\/[^/\\\u0000-\u001f<>:"|?*]+\.md$/.test(path))
+            throw new Error(`Invalid site Skill bundle path: ${path}; only SKILL.md and references/*.md are allowed`);
+        if (typeof content !== 'string')
+            throw new Error(`Invalid site Skill bundle content: ${path}`);
+    }
+    const header = skillFrontmatter(files['SKILL.md']);
+    if (header.value.name !== skillName)
+        throw new Error('Invalid site Skill bundle: SKILL.md frontmatter name must match skillName');
+    return { skillName, hash, files: files };
+}
+export async function installAgentToolsSkill(options, runtime = ONLINE_RUNTIME_PROFILE, site, explicitProfile) {
+    const workspace = process.cwd();
+    const config = site ? undefined : readConfig(workspace);
+    if (config)
+        assertProjectRuntimeProfile(config.runtimeProfile, runtime);
+    const siteToken = site ? parseSiteToken(site) : config.appToken;
+    const { env } = resolveLarkProfileEnvironment(await runtime.commandEnvironment(), explicitProfile, config?.larkProfile, runtime);
+    let rawBundle;
+    try {
+        rawBundle = responseData(runLarkCli([
+            'api',
+            'GET',
+            `/open-apis/base/v3/sites/${encodeURIComponent(siteToken)}/skill`,
+        ], env, config ? workspace : homedir()));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const logId = safeDiagnostic((error instanceof LarkCliError ? error.details.logId : undefined) ??
+            /LogID:\s*([A-Za-z0-9_-]+)[).\s]*$/.exec(message)?.[1], env, 128);
+        const failure = (text) => {
+            const failure = new LarkCliError({
+                ...(error instanceof LarkCliError
+                    ? error.details
+                    : { kind: 'api' }),
+                message: text,
+                ...(logId ? { logId } : {}),
+            });
+            failure.cause = error;
+            return failure;
+        };
+        if (/This site has not been published to prod|No published version is available/i.test(message))
+            throw failure('This site has no published version to install. Parameter: site. Fix: Ask the site owner to publish the site, then retry the installation.');
+        if (/current account does not have access|not visible to the current caller|ErrPermNotAllow/i.test(message))
+            throw failure('The current account cannot access this site Skill. Parameter: site. Fix: Ask a site administrator to add you to the site, then retry the installation.');
+        throw error;
+    }
+    const bundle = validateSiteSkillBundle(rawBundle);
+    // Validate the whole bundle before creating files or touching any installation.
+    const temporary = mkdtempSync(join(tmpdir(), 'base-database-site-skill-'));
+    try {
+        for (const [path, content] of Object.entries(bundle.files)) {
+            const target = join(temporary, path);
+            mkdirSync(dirname(target), { recursive: true });
+            writeFileSync(target, content);
+        }
+        let installName = bundle.skillName;
+        let tracked = [];
+        const receiptFile = userReceiptPath();
+        if (site) {
+            tracked = readUserReceipt(receiptFile);
+            const destinations = skillDestinations(options, installName);
+            const conflicts = destinations.some((directory) => existsSync(directory) &&
+                tracked.some((item) => item.directory === directory && item.siteToken !== siteToken));
+            if (conflicts) {
+                installName = `${bundle.skillName.slice(0, 57).replace(/-+$/, '')}-${createHash('sha256').update(siteToken).digest('hex').slice(0, 6)}`;
+                process.stderr.write(`Warning: Another site already uses this Skill name in the destination. Will use ${installName} to preserve that installation. After installation succeeds, use the new name to access this site.\n`);
+            }
+        }
+        const installBundle = installName === bundle.skillName
+            ? bundle
+            : {
+                ...bundle,
+                skillName: installName,
+                files: {
+                    ...bundle.files,
+                    'SKILL.md': skillFrontmatter(bundle.files['SKILL.md']).rename(installName),
+                },
+            };
+        validateSiteSkillBundle(installBundle);
+        if (installBundle !== bundle) {
+            for (const [path, content] of Object.entries(installBundle.files)) {
+                const target = join(temporary, path);
+                mkdirSync(dirname(target), { recursive: true });
+                writeFileSync(target, content);
+            }
+        }
+        const installed = installSkillDirectory(temporary, installName, options, (directory) => Boolean(site) &&
+            tracked.some((item) => item.directory === directory &&
+                item.siteToken === siteToken &&
+                item.runtime === runtime.name));
+        try {
+            if (site)
+                writeUserReceipt(receiptFile, tracked, siteToken, runtime.name, installBundle, installed);
+            else
+                recordSiteSkillInstallation(workspace, siteToken, runtime.name, bundle, installed);
+        }
+        catch {
+            process.stderr.write(site
+                ? 'Warning: The Skill was installed, but its user-level installation record could not be saved. Fix: Check write access to the user CLI state directory and verify the destination site before reinstalling; name-conflict protection cannot reliably identify the existing site.\n'
+                : 'Warning: The Skill was installed, but its project installation record could not be saved. Fix: Check write access to the project CLI state directory before updating the installation.\n');
+        }
+        return {
+            ok: true,
+            installed,
+            skillName: installName,
+            hash: bundle.hash,
+        };
+    }
+    finally {
+        rmSync(temporary, { recursive: true, force: true });
+    }
+}
+function userReceiptPath() {
+    return join(homedir(), '.base-database-cli/state/agent-tools-skills.json');
+}
+function readUserReceipt(path) {
+    try {
+        const value = JSON.parse(readFileSync(path, 'utf8'));
+        return Array.isArray(value.installations)
+            ? value.installations.filter((item) => isRecord(item) &&
+                typeof item.siteToken === 'string' &&
+                typeof item.runtime === 'string' &&
+                typeof item.directory === 'string' &&
+                typeof item.hash === 'string' &&
+                isRecord(item.files) &&
+                Object.values(item.files).every((hash) => typeof hash === 'string'))
+            : [];
+    }
+    catch {
+        return [];
+    }
+}
+function writeUserReceipt(path, existing, siteToken, runtime, bundle, directories) {
+    const files = Object.fromEntries(Object.entries(bundle.files).map(([name, content]) => [
+        name,
+        createHash('sha256').update(content).digest('hex'),
+    ]));
+    const installations = existing.filter((item) => !directories.includes(item.directory));
+    installations.push(...directories.map((directory) => ({
+        siteToken,
+        runtime,
+        directory,
+        hash: bundle.hash,
+        files,
+    })));
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify({ installations }, null, 2) + '\n');
+}
+function parseSiteToken(value) {
+    const input = value.trim();
+    let token = input;
+    if (/^https?:\/\//i.test(input)) {
+        let url;
+        try {
+            url = new URL(input);
+        }
+        catch {
+            throw new LarkCliError({
+                kind: 'invalid_response',
+                code: 'SITE_SKILL_INVALID_SITE',
+                message: 'Invalid site URL. Parameter: --site. Fix: Copy the full application URL from a successful publication, or provide its site token.',
+            });
+        }
+        const parts = url.pathname.split('/').filter(Boolean);
+        token = parts.at(-1) ?? '';
+        if (!parts.some((part) => /^(?:app|baseapp)$/i.test(part)))
+            throw new LarkCliError({
+                kind: 'invalid_response',
+                code: 'SITE_SKILL_INVALID_SITE',
+                message: 'The URL is not an application link. Parameter: --site. Fix: Use the application URL returned by publication, with an /app/ or /baseapp/ path.',
+            });
+    }
+    if (!/^[A-Za-z0-9_-]{1,256}$/.test(token))
+        throw new LarkCliError({
+            kind: 'invalid_response',
+            code: 'SITE_SKILL_INVALID_SITE',
+            message: 'Invalid site token. Parameter: --site. Fix: Provide a site token of 1 to 256 letters, digits, underscores or hyphens, or the full application URL.',
+        });
+    return token;
+}
+//# sourceMappingURL=agent-tools-skill.js.map

package/dist/agent-tools-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools-skill.js","sourceRoot":"","sources":["../src/agent-tools-skill.ts"],"names":[],"mappings":"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"}

package/dist/agent-tools.d.ts

@@ -0,0 +1,20 @@
+export declare const AGENT_TOOLS_FILE = "agent-tools.json";
+export interface AgentTools {
+    present: boolean;
+    exclude: string[];
+    tools: string[];
+}
+export declare class AgentToolsValidationError extends Error {
+    readonly code = "AGENT_TOOLS_INVALID";
+    constructor(message: string);
+}
+export declare const AI_AGENT_TOOLS_SKIPPED = "AI_AGENT_TOOLS_SKIPPED";
+/** Validate the local inventory first, then project the policy for this operation. */
+export declare function readAgentTools(workspace: string, options?: {
+    skipAIFunctions?: boolean;
+    onWarning?: (message: string) => void;
+}): AgentTools;
+/** Do not infer unsupported routes from a generic resource NotFound or transport failure. */
+export declare function isAgentToolsUnsupported(error: unknown): boolean;
+export declare function updateAgentTools(workspace: string, appToken: string, policy: AgentTools, env: NodeJS.ProcessEnv): void;
+//# sourceMappingURL=agent-tools.d.ts.map

package/dist/agent-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools.d.ts","sourceRoot":"","sources":["../src/agent-tools.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAEnD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,yBAAyB;IACtC,YAAY,OAAO,EAAE,MAAM,EAE1B;CACF;AAED,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAE/D,sFAAsF;AACtF,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC,GACL,UAAU,CA0FZ;AAED,6FAA6F;AAC7F,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAoB/D;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,IAAI,CA6BN"}