@lark-base-open/base-database-cli 1.3.9 → 1.4.3

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,29 @@
+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;
+    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,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,CA6GpB;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,169 @@
+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`;
+    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,
+        };
+    }
+    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,
+        ...(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' && externalAgent.installation.available
+        ? ` Read the SKILL.md function list using \`${externalAgent.skillCommand}\` (externalAgent.skillCommand), and add “可用能力” to the delivery in business language. Describe only capabilities actually present in that list; do not infer capabilities. If reading fails, state that the site Skill is temporarily unavailable and omit the capability list.`
+        : '';
+    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":"AAeA,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;;;;;GAiJzB"}

package/dist/agent-tools-skill.js

@@ -0,0 +1,183 @@
+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);
+        if (/This site has not been published to prod|No published version is available/i.test(message))
+            throw new Error('该站点尚未发布正式版，正式版发布后才能安装站点 Skill。', { cause: error });
+        if (/current account does not have access|not visible to the current caller|ErrPermNotAllow/i.test(message))
+            throw new Error('当前登录用户无权访问该站点 Skill，请确认你已加入站点并具有访问权限。', { cause: error });
+        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(`目标目录已有其他站点的同名 Skill；本次使用 ${installName} 避免覆盖。\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: Skill 已安装，但无法保存用户级站点摘要；跨站同名保护无法可靠判断安装来源。\n'
+                : 'Warning: Skill 已安装，但无法保存本地安装摘要。\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 Error('无效的站点链接');
+        }
+        const parts = url.pathname.split('/').filter(Boolean);
+        token = parts.at(-1) ?? '';
+        if (!parts.some((part) => /^(?:app|baseapp)$/i.test(part)))
+            throw new Error('站点链接应为 baseAppUrl 格式');
+    }
+    if (!/^[A-Za-z0-9_-]{1,256}$/.test(token))
+        throw new Error('站点 token 格式无效');
+    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"}