koa-boot-runtime 1.0.0

package/dist/aiToolRegistry.d.ts

@@ -0,0 +1,32 @@
+import type { AiToolDef } from './utils/aiClient';
+/**
+ * AI 工具注册表（框架机制，业务工具由用户在项目侧注册）。
+ *
+ * 原则：
+ * - 只注册查询类只读工具，不暴露写操作
+ * - 工具执行函数内部自行收口数据权限
+ * - 业务工具通过 registerAiTool 注册，框架通过 listToolDefs 获取定义
+ */
+export interface AiToolContext {
+    userId: string;
+    roles: string[];
+}
+/** AI 工具：JSON Schema 定义（给模型）+ 执行函数（查库） */
+export interface AiTool {
+    definition: AiToolDef;
+    execute: (args: Record<string, any>, ctx: AiToolContext) => Promise<unknown>;
+}
+/**
+ * 注册一个 AI 工具。
+ * 名称取自 definition.function.name，重复注册会覆盖（便于热更新）。
+ */
+export declare function registerAiTool(tool: AiTool): void;
+/** 批量注册工具 */
+export declare function registerAiTools(tools: AiTool[]): void;
+export declare function getAiTool(name: string): AiTool | undefined;
+export declare function hasAiTool(name: string): boolean;
+/** 全部已注册工具 */
+export declare function listAiTools(): AiTool[];
+/** 供 AI 对话随请求发送的工具定义（JSON Schema） */
+export declare function listToolDefs(): AiToolDef[];
+//# sourceMappingURL=aiToolRegistry.d.ts.map

package/dist/aiToolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiToolRegistry.d.ts","sourceRoot":"","sources":["../src/aiToolRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,0CAA0C;AAC1C,MAAM,WAAW,MAAM;IACrB,UAAU,EAAE,SAAS,CAAC;IACtB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9E;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMjD;AAED,aAAa;AACb,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAIrD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,cAAc;AACd,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC;AAED,qCAAqC;AACrC,wBAAgB,YAAY,IAAI,SAAS,EAAE,CAE1C"}

package/dist/aiToolRegistry.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAiTool = registerAiTool;
+exports.registerAiTools = registerAiTools;
+exports.getAiTool = getAiTool;
+exports.hasAiTool = hasAiTool;
+exports.listAiTools = listAiTools;
+exports.listToolDefs = listToolDefs;
+const registry = new Map();
+/**
+ * 注册一个 AI 工具。
+ * 名称取自 definition.function.name，重复注册会覆盖（便于热更新）。
+ */
+function registerAiTool(tool) {
+    const name = tool.definition.function.name;
+    if (!name) {
+        throw new Error('[aiToolRegistry] tool definition must have function.name');
+    }
+    registry.set(name, tool);
+}
+/** 批量注册工具 */
+function registerAiTools(tools) {
+    for (const tool of tools) {
+        registerAiTool(tool);
+    }
+}
+function getAiTool(name) {
+    return registry.get(name);
+}
+function hasAiTool(name) {
+    return registry.has(name);
+}
+/** 全部已注册工具 */
+function listAiTools() {
+    return [...registry.values()];
+}
+/** 供 AI 对话随请求发送的工具定义（JSON Schema） */
+function listToolDefs() {
+    return [...registry.values()].map((t) => t.definition);
+}
+//# sourceMappingURL=aiToolRegistry.js.map

package/dist/aiToolRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiToolRegistry.js","sourceRoot":"","sources":["../src/aiToolRegistry.ts"],"names":[],"mappings":";;AA2BA,wCAMC;AAGD,0CAIC;AAED,8BAEC;AAED,8BAEC;AAGD,kCAEC;AAGD,oCAEC;AArCD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;AAE3C;;;GAGG;AACH,SAAgB,cAAc,CAAC,IAAY;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,aAAa;AACb,SAAgB,eAAe,CAAC,KAAe;IAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,cAAc,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,SAAgB,SAAS,CAAC,IAAY;IACpC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,SAAgB,SAAS,CAAC,IAAY;IACpC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,cAAc;AACd,SAAgB,WAAW;IACzB,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,qCAAqC;AACrC,SAAgB,YAAY;IAC1B,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;AACzD,CAAC"}

package/dist/build/routes.d.ts

@@ -0,0 +1,3 @@
+import type { Router } from '@koa/router';
+export declare function RegisterRoutes(router: Router): void;
+//# sourceMappingURL=routes.d.ts.map

package/dist/build/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/build/routes.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAs4B1C,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,QAq0H5C"}