@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 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) => 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;
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) => 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
+ };
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
- 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);
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:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kwirthmagnify/kwirth-common-ai",
3
- "version": "0.5.59",
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",