@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 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) => ToolSet;
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) => builtInToolsetIds.has(id) ? false : toolsetRegistry.delete(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
- const { effective } = (0, exports.resolveTools)(config);
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:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kwirthmagnify/kwirth-common-ai",
3
- "version": "0.5.60",
3
+ "version": "0.5.61",
4
4
  "description": "Shared AI/LLM types and utilities for Kwirth AI plugins",
5
5
  "scripts": {
6
6
  "build": "del .\\dist\\* /s /q 2>nul & tsc",