@kwirthmagnify/kwirth-common-ai 0.5.60 → 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 +21 -2
- package/dist/back.js +48 -6
- package/package.json +1 -1
package/dist/back.d.ts
CHANGED
|
@@ -182,6 +182,12 @@ export declare const defineTool: <S extends z.ZodTypeAny>(definition: {
|
|
|
182
182
|
execute: (args: z.infer<S>, host: IToolHost) => Promise<unknown>;
|
|
183
183
|
}) => IAiTool;
|
|
184
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;
|
|
185
191
|
/**
|
|
186
192
|
* Registra un toolset. `builtIn` solo lo usa el core para los suyos: marca el id como reservado.
|
|
187
193
|
* Lanza si el id ya esta ocupado — registrar dos veces el mismo id es un error de empaquetado, no algo
|
|
@@ -234,6 +240,14 @@ export interface IToolResolution {
|
|
|
234
240
|
shadowed: IShadowedTool[];
|
|
235
241
|
/** Toolsets asignados que no estan registrados (desinstalados, o nunca instalados). */
|
|
236
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[];
|
|
237
251
|
}
|
|
238
252
|
/**
|
|
239
253
|
* Aplica el techo de un cliente sobre el registro. Pura: ni ejecuta ni toca el contexto, asi que el
|
|
@@ -242,7 +256,7 @@ export interface IToolResolution {
|
|
|
242
256
|
* Una tool apagada no tapa: se apaga una referencia concreta ('ts1/td'), no un nombre, asi que si `ts1/td`
|
|
243
257
|
* esta apagada y `ts2` trae otra `td`, aflora la de `ts2`.
|
|
244
258
|
*/
|
|
245
|
-
export declare const resolveTools: (config: IToolsetConfig) => IToolResolution;
|
|
259
|
+
export declare const resolveTools: (config: IToolsetConfig, requesterId?: string) => IToolResolution;
|
|
246
260
|
/** Una invocacion concreta, tal y como la ven los dos ganchos. */
|
|
247
261
|
export interface IToolInvocation {
|
|
248
262
|
ref: string;
|
|
@@ -274,7 +288,12 @@ export interface IAgentToolHooks {
|
|
|
274
288
|
* Las tools listas para pasarselas al SDK de IA, ya resueltas por precedencia y con los dos ganchos
|
|
275
289
|
* puestos. La clave del objeto es el nombre CORTO, que es lo unico que el proveedor acepta.
|
|
276
290
|
*/
|
|
277
|
-
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;
|
|
278
297
|
export declare const tools: {
|
|
279
298
|
readonly list_namespaces: Tool<Record<string, never>, {
|
|
280
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");
|
|
@@ -407,8 +407,30 @@ const toolsetRegistry = new Map();
|
|
|
407
407
|
// ocuparlos. Sin esta regla, instalar un toolset ajeno llamado 'k8s-inventory' obligaria a renombrar el
|
|
408
408
|
// built-in, y con el se romperia todo techo y todo agente que lo tuviera configurado.
|
|
409
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
|
|
410
421
|
const isBuiltInToolsetId = (id) => builtInToolsetIds.has(id);
|
|
411
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;
|
|
412
434
|
/**
|
|
413
435
|
* Registra un toolset. `builtIn` solo lo usa el core para los suyos: marca el id como reservado.
|
|
414
436
|
* Lanza si el id ya esta ocupado — registrar dos veces el mismo id es un error de empaquetado, no algo
|
|
@@ -429,7 +451,14 @@ const registerToolset = (toolset, builtIn = false) => {
|
|
|
429
451
|
};
|
|
430
452
|
exports.registerToolset = registerToolset;
|
|
431
453
|
/** Retira un toolset del registro (desinstalacion). Los built-in no se retiran. */
|
|
432
|
-
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
|
+
};
|
|
433
462
|
exports.unregisterToolset = unregisterToolset;
|
|
434
463
|
const getToolset = (id) => toolsetRegistry.get(id);
|
|
435
464
|
exports.getToolset = getToolset;
|
|
@@ -507,11 +536,12 @@ exports.resolveToolRef = resolveToolRef;
|
|
|
507
536
|
* Una tool apagada no tapa: se apaga una referencia concreta ('ts1/td'), no un nombre, asi que si `ts1/td`
|
|
508
537
|
* esta apagada y `ts2` trae otra `td`, aflora la de `ts2`.
|
|
509
538
|
*/
|
|
510
|
-
const resolveTools = (config) => {
|
|
539
|
+
const resolveTools = (config, requesterId) => {
|
|
511
540
|
const disabled = new Set(config.disabledTools);
|
|
512
541
|
const effective = [];
|
|
513
542
|
const shadowed = [];
|
|
514
543
|
const missing = [];
|
|
544
|
+
const notGranted = [];
|
|
515
545
|
const taken = new Map(); // nombre corto → toolset que lo sirve
|
|
516
546
|
for (const toolsetId of config.activeToolsets) {
|
|
517
547
|
const toolset = toolsetRegistry.get(toolsetId);
|
|
@@ -521,6 +551,13 @@ const resolveTools = (config) => {
|
|
|
521
551
|
missing.push(toolsetId);
|
|
522
552
|
continue;
|
|
523
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
|
+
}
|
|
524
561
|
for (const tool of toolset.tools) {
|
|
525
562
|
const ref = (0, index_1.toolRef)(toolsetId, tool.name);
|
|
526
563
|
if (disabled.has(ref))
|
|
@@ -534,15 +571,20 @@ const resolveTools = (config) => {
|
|
|
534
571
|
effective.push({ name: tool.name, ref, toolsetId, tool });
|
|
535
572
|
}
|
|
536
573
|
}
|
|
537
|
-
return { effective, shadowed, missing };
|
|
574
|
+
return { effective, shadowed, missing, notGranted };
|
|
538
575
|
};
|
|
539
576
|
exports.resolveTools = resolveTools;
|
|
540
577
|
/**
|
|
541
578
|
* Las tools listas para pasarselas al SDK de IA, ya resueltas por precedencia y con los dos ganchos
|
|
542
579
|
* puestos. La clave del objeto es el nombre CORTO, que es lo unico que el proveedor acepta.
|
|
543
580
|
*/
|
|
544
|
-
const buildAgentTools = (config, context, hooks = {}
|
|
545
|
-
|
|
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);
|
|
546
588
|
const entries = effective.map(e => {
|
|
547
589
|
const invocationOf = (args) => ({ ref: e.ref, toolsetId: e.toolsetId, toolName: e.name, args });
|
|
548
590
|
// ⚠️ Un objeto PLANO, no `dynamicTool`. Parece equivalente y no lo es:
|