@kwirthmagnify/kwirth-common-ai 0.5.59 → 0.5.61
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/dist/back.d.ts +22 -2
- package/dist/back.js +50 -6
- package/package.json +1 -1
package/dist/back.d.ts
CHANGED
|
@@ -30,6 +30,7 @@ export interface IVisionOptions<T> {
|
|
|
30
30
|
export declare const generateVision: <T>(opts: IVisionOptions<T>) => Promise<IVisionResult<T>>;
|
|
31
31
|
export declare const loadModels: (providers: ILlmProvider[], log: ILogChannel) => Promise<void>;
|
|
32
32
|
export { generateText, Output, stepCountIs, tool } from 'ai';
|
|
33
|
+
export type { LanguageModel, ToolSet } from 'ai';
|
|
33
34
|
export { z } from 'zod';
|
|
34
35
|
export declare const zodFromExample: (example: Record<string, unknown>) => z.ZodObject<Record<string, z.ZodTypeAny>>;
|
|
35
36
|
export interface ISourceRepoCred {
|
|
@@ -181,6 +182,12 @@ export declare const defineTool: <S extends z.ZodTypeAny>(definition: {
|
|
|
181
182
|
execute: (args: z.infer<S>, host: IToolHost) => Promise<unknown>;
|
|
182
183
|
}) => IAiTool;
|
|
183
184
|
export declare const isBuiltInToolsetId: (id: string) => boolean;
|
|
185
|
+
/** Concede un toolset a una lista de plugins. Reemplaza la concesion anterior; `[]` se la quita a todos. */
|
|
186
|
+
export declare const setToolsetGrants: (toolsetId: string, pluginIds: string[]) => void;
|
|
187
|
+
/** A quien esta concedido un toolset. Vacio = a nadie, que es el estado por defecto. */
|
|
188
|
+
export declare const getToolsetGrants: (toolsetId: string) => string[];
|
|
189
|
+
/** Si ESE plugin puede usar ESE toolset. */
|
|
190
|
+
export declare const isToolsetGrantedTo: (toolsetId: string, pluginId: string) => boolean;
|
|
184
191
|
/**
|
|
185
192
|
* Registra un toolset. `builtIn` solo lo usa el core para los suyos: marca el id como reservado.
|
|
186
193
|
* Lanza si el id ya esta ocupado — registrar dos veces el mismo id es un error de empaquetado, no algo
|
|
@@ -233,6 +240,14 @@ export interface IToolResolution {
|
|
|
233
240
|
shadowed: IShadowedTool[];
|
|
234
241
|
/** Toolsets asignados que no estan registrados (desinstalados, o nunca instalados). */
|
|
235
242
|
missing: string[];
|
|
243
|
+
/**
|
|
244
|
+
* Toolsets que SI estan instalados pero que a este plugin no se le han concedido.
|
|
245
|
+
*
|
|
246
|
+
* Se reporta aparte de `missing` a proposito: "no esta instalado" lo arregla el admin instalandolo, y
|
|
247
|
+
* "no te lo han concedido" lo arregla concediendolo. Meterlos en el mismo saco manda al admin a buscar
|
|
248
|
+
* en el sitio equivocado.
|
|
249
|
+
*/
|
|
250
|
+
notGranted: string[];
|
|
236
251
|
}
|
|
237
252
|
/**
|
|
238
253
|
* Aplica el techo de un cliente sobre el registro. Pura: ni ejecuta ni toca el contexto, asi que el
|
|
@@ -241,7 +256,7 @@ export interface IToolResolution {
|
|
|
241
256
|
* Una tool apagada no tapa: se apaga una referencia concreta ('ts1/td'), no un nombre, asi que si `ts1/td`
|
|
242
257
|
* esta apagada y `ts2` trae otra `td`, aflora la de `ts2`.
|
|
243
258
|
*/
|
|
244
|
-
export declare const resolveTools: (config: IToolsetConfig) => IToolResolution;
|
|
259
|
+
export declare const resolveTools: (config: IToolsetConfig, requesterId?: string) => IToolResolution;
|
|
245
260
|
/** Una invocacion concreta, tal y como la ven los dos ganchos. */
|
|
246
261
|
export interface IToolInvocation {
|
|
247
262
|
ref: string;
|
|
@@ -273,7 +288,12 @@ export interface IAgentToolHooks {
|
|
|
273
288
|
* Las tools listas para pasarselas al SDK de IA, ya resueltas por precedencia y con los dos ganchos
|
|
274
289
|
* puestos. La clave del objeto es el nombre CORTO, que es lo unico que el proveedor acepta.
|
|
275
290
|
*/
|
|
276
|
-
export declare const buildAgentTools: (config: IToolsetConfig, context: IToolContext, hooks?: IAgentToolHooks
|
|
291
|
+
export declare const buildAgentTools: (config: IToolsetConfig, context: IToolContext, hooks?: IAgentToolHooks,
|
|
292
|
+
/**
|
|
293
|
+
* Quien pide las tools. Sin esto no se filtra por concesion, asi que un plugin DEBE pasar su id: es lo
|
|
294
|
+
* que impide que se sirva a si mismo un toolset que no le han concedido.
|
|
295
|
+
*/
|
|
296
|
+
requesterId?: string) => ToolSet;
|
|
277
297
|
export declare const tools: {
|
|
278
298
|
readonly list_namespaces: Tool<Record<string, never>, {
|
|
279
299
|
namespaces: any;
|
package/dist/back.js
CHANGED
|
@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
|
|
|
33
33
|
};
|
|
34
34
|
})();
|
|
35
35
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
36
|
-
exports.runAgent = exports.selectAgentToolNames = exports.toolInfoList = exports.tools = exports.buildAgentTools = exports.resolveTools = exports.resolveToolRef = exports.invokeToolRef = exports.buildToolHost = exports.listToolsetInfos = exports.listToolsets = exports.getToolset = exports.unregisterToolset = exports.registerToolset = exports.isBuiltInToolsetId = exports.defineTool = exports.runWithToolContext = exports.EToolEffect = exports.zodFromExample = exports.z = exports.tool = exports.stepCountIs = exports.Output = exports.generateText = exports.loadModels = exports.generateVision = exports.buildModel = void 0;
|
|
36
|
+
exports.runAgent = exports.selectAgentToolNames = exports.toolInfoList = exports.tools = exports.buildAgentTools = exports.resolveTools = exports.resolveToolRef = exports.invokeToolRef = exports.buildToolHost = exports.listToolsetInfos = exports.listToolsets = exports.getToolset = exports.unregisterToolset = exports.registerToolset = exports.isToolsetGrantedTo = exports.getToolsetGrants = exports.setToolsetGrants = exports.isBuiltInToolsetId = exports.defineTool = exports.runWithToolContext = exports.EToolEffect = exports.zodFromExample = exports.z = exports.tool = exports.stepCountIs = exports.Output = exports.generateText = exports.loadModels = exports.generateVision = exports.buildModel = void 0;
|
|
37
37
|
const index_1 = require("./index");
|
|
38
38
|
const ai_1 = require("ai");
|
|
39
39
|
const zod_1 = require("zod");
|
|
@@ -258,6 +258,8 @@ const inferZod = (value) => {
|
|
|
258
258
|
return zod_1.z.unknown();
|
|
259
259
|
};
|
|
260
260
|
// Re-export AI SDK symbols so plugins can use them without bundling the SDK
|
|
261
|
+
// Se re-exportan tambien los TIPOS que necesita quien escriba un helper alrededor de generateText: sin
|
|
262
|
+
// LanguageModel y ToolSet, un plugin no puede tipar sus propias funciones y acaba con 'any'.
|
|
261
263
|
var ai_2 = require("ai");
|
|
262
264
|
Object.defineProperty(exports, "generateText", { enumerable: true, get: function () { return ai_2.generateText; } });
|
|
263
265
|
Object.defineProperty(exports, "Output", { enumerable: true, get: function () { return ai_2.Output; } });
|
|
@@ -405,8 +407,30 @@ const toolsetRegistry = new Map();
|
|
|
405
407
|
// ocuparlos. Sin esta regla, instalar un toolset ajeno llamado 'k8s-inventory' obligaria a renombrar el
|
|
406
408
|
// built-in, y con el se romperia todo techo y todo agente que lo tuviera configurado.
|
|
407
409
|
const builtInToolsetIds = new Set();
|
|
410
|
+
/*
|
|
411
|
+
Quien puede usar cada toolset (plan: "El techo en dos fases", fase 1).
|
|
412
|
+
|
|
413
|
+
⚠️ La concesion vive AQUI, en el registro, y no en la llamada. Si cada plugin armara su propia lista de
|
|
414
|
+
toolsets, podria pedir los que no se le han concedido: el filtro tiene que estar del lado que el plugin
|
|
415
|
+
no controla. El registro lo puebla el core, y un paquete de terceros no puede tocarlo.
|
|
416
|
+
|
|
417
|
+
Y por defecto NO lo usa nadie (decision del usuario, 2026-09-17): instalar un toolset lo deja
|
|
418
|
+
disponible, no concedido. Instalar `k8s-ops` no puede dar escritura a nadie por accidente.
|
|
419
|
+
*/
|
|
420
|
+
const toolsetGrants = new Map(); // toolsetId → plugins invitados
|
|
408
421
|
const isBuiltInToolsetId = (id) => builtInToolsetIds.has(id);
|
|
409
422
|
exports.isBuiltInToolsetId = isBuiltInToolsetId;
|
|
423
|
+
/** Concede un toolset a una lista de plugins. Reemplaza la concesion anterior; `[]` se la quita a todos. */
|
|
424
|
+
const setToolsetGrants = (toolsetId, pluginIds) => {
|
|
425
|
+
toolsetGrants.set(toolsetId, new Set(pluginIds));
|
|
426
|
+
};
|
|
427
|
+
exports.setToolsetGrants = setToolsetGrants;
|
|
428
|
+
/** A quien esta concedido un toolset. Vacio = a nadie, que es el estado por defecto. */
|
|
429
|
+
const getToolsetGrants = (toolsetId) => { var _a; return [...((_a = toolsetGrants.get(toolsetId)) !== null && _a !== void 0 ? _a : [])]; };
|
|
430
|
+
exports.getToolsetGrants = getToolsetGrants;
|
|
431
|
+
/** Si ESE plugin puede usar ESE toolset. */
|
|
432
|
+
const isToolsetGrantedTo = (toolsetId, pluginId) => { var _a, _b; return (_b = (_a = toolsetGrants.get(toolsetId)) === null || _a === void 0 ? void 0 : _a.has(pluginId)) !== null && _b !== void 0 ? _b : false; };
|
|
433
|
+
exports.isToolsetGrantedTo = isToolsetGrantedTo;
|
|
410
434
|
/**
|
|
411
435
|
* Registra un toolset. `builtIn` solo lo usa el core para los suyos: marca el id como reservado.
|
|
412
436
|
* Lanza si el id ya esta ocupado — registrar dos veces el mismo id es un error de empaquetado, no algo
|
|
@@ -427,7 +451,14 @@ const registerToolset = (toolset, builtIn = false) => {
|
|
|
427
451
|
};
|
|
428
452
|
exports.registerToolset = registerToolset;
|
|
429
453
|
/** Retira un toolset del registro (desinstalacion). Los built-in no se retiran. */
|
|
430
|
-
const unregisterToolset = (id) =>
|
|
454
|
+
const unregisterToolset = (id) => {
|
|
455
|
+
if (builtInToolsetIds.has(id))
|
|
456
|
+
return false;
|
|
457
|
+
// La concesion se va con el toolset: dejarla huerfana haria que reinstalarlo resucitara permisos que
|
|
458
|
+
// nadie ha vuelto a conceder.
|
|
459
|
+
toolsetGrants.delete(id);
|
|
460
|
+
return toolsetRegistry.delete(id);
|
|
461
|
+
};
|
|
431
462
|
exports.unregisterToolset = unregisterToolset;
|
|
432
463
|
const getToolset = (id) => toolsetRegistry.get(id);
|
|
433
464
|
exports.getToolset = getToolset;
|
|
@@ -505,11 +536,12 @@ exports.resolveToolRef = resolveToolRef;
|
|
|
505
536
|
* Una tool apagada no tapa: se apaga una referencia concreta ('ts1/td'), no un nombre, asi que si `ts1/td`
|
|
506
537
|
* esta apagada y `ts2` trae otra `td`, aflora la de `ts2`.
|
|
507
538
|
*/
|
|
508
|
-
const resolveTools = (config) => {
|
|
539
|
+
const resolveTools = (config, requesterId) => {
|
|
509
540
|
const disabled = new Set(config.disabledTools);
|
|
510
541
|
const effective = [];
|
|
511
542
|
const shadowed = [];
|
|
512
543
|
const missing = [];
|
|
544
|
+
const notGranted = [];
|
|
513
545
|
const taken = new Map(); // nombre corto → toolset que lo sirve
|
|
514
546
|
for (const toolsetId of config.activeToolsets) {
|
|
515
547
|
const toolset = toolsetRegistry.get(toolsetId);
|
|
@@ -519,6 +551,13 @@ const resolveTools = (config) => {
|
|
|
519
551
|
missing.push(toolsetId);
|
|
520
552
|
continue;
|
|
521
553
|
}
|
|
554
|
+
// La concesion se comprueba AQUI y no la aporta quien llama: el plugin no puede concederse a si
|
|
555
|
+
// mismo lo que el admin no le dio. Sin `requesterId` no se filtra — es el caso del core
|
|
556
|
+
// resolviendo para PINTAR (el editor), no para ejecutar.
|
|
557
|
+
if (requesterId !== undefined && !(0, exports.isToolsetGrantedTo)(toolsetId, requesterId)) {
|
|
558
|
+
notGranted.push(toolsetId);
|
|
559
|
+
continue;
|
|
560
|
+
}
|
|
522
561
|
for (const tool of toolset.tools) {
|
|
523
562
|
const ref = (0, index_1.toolRef)(toolsetId, tool.name);
|
|
524
563
|
if (disabled.has(ref))
|
|
@@ -532,15 +571,20 @@ const resolveTools = (config) => {
|
|
|
532
571
|
effective.push({ name: tool.name, ref, toolsetId, tool });
|
|
533
572
|
}
|
|
534
573
|
}
|
|
535
|
-
return { effective, shadowed, missing };
|
|
574
|
+
return { effective, shadowed, missing, notGranted };
|
|
536
575
|
};
|
|
537
576
|
exports.resolveTools = resolveTools;
|
|
538
577
|
/**
|
|
539
578
|
* Las tools listas para pasarselas al SDK de IA, ya resueltas por precedencia y con los dos ganchos
|
|
540
579
|
* puestos. La clave del objeto es el nombre CORTO, que es lo unico que el proveedor acepta.
|
|
541
580
|
*/
|
|
542
|
-
const buildAgentTools = (config, context, hooks = {}
|
|
543
|
-
|
|
581
|
+
const buildAgentTools = (config, context, hooks = {},
|
|
582
|
+
/**
|
|
583
|
+
* Quien pide las tools. Sin esto no se filtra por concesion, asi que un plugin DEBE pasar su id: es lo
|
|
584
|
+
* que impide que se sirva a si mismo un toolset que no le han concedido.
|
|
585
|
+
*/
|
|
586
|
+
requesterId) => {
|
|
587
|
+
const { effective } = (0, exports.resolveTools)(config, requesterId);
|
|
544
588
|
const entries = effective.map(e => {
|
|
545
589
|
const invocationOf = (args) => ({ ref: e.ref, toolsetId: e.toolsetId, toolName: e.name, args });
|
|
546
590
|
// ⚠️ Un objeto PLANO, no `dynamicTool`. Parece equivalente y no lo es:
|