katanakit-js 6.2.0 → 6.6.1

package/dist/core/services/access.service.js

@@ -1,3 +1,6 @@
+/* -------------------------------------------------------------------------- */
+/* Role hierarchy (shared between strategies)                                 */
+/* -------------------------------------------------------------------------- */
 /**
  * Role ranks: lower number = more privileged. Higher-privilege roles inherit
  * the capabilities of every role below them (e.g. `admin` can do everything
@@ -13,7 +16,7 @@ const ROLE_RANK = {
 };
 /**
  * Default role registry: each role lists only the capabilities it adds on top
- * of the roles below it. `guest` adds none — read access is public by default.
+ * of the roles below it. `guest` adds none - read access is public by default.
  */
 const DEFAULT_ROLES = [
     { slug: "owner", label: "Owner", capabilities: ["roles:assign", "system:admin"] },
@@ -40,58 +43,265 @@ const DEFAULT_ROLES = [
 function useCopy(definition) {
     return { ...definition, capabilities: [...definition.capabilities] };
 }
-/** Active registry, keyed by role slug. Starts as the default set. */
-const registry = new Map(DEFAULT_ROLES.map((role) => [role.slug, role]));
-function useDefinitionFor(role) {
-    const definition = registry.get(role);
-    if (!definition) {
-        throw new Error(`Unknown access role: ${role}`);
-    }
-    return definition;
+/* -------------------------------------------------------------------------- */
+/* Concrete strategies                                                        */
+/* -------------------------------------------------------------------------- */
+/**
+ * Estrategia por defecto: control de acceso jerárquico basado en roles
+ * registrados. Es la estrategia estándar del servicio.
+ *
+ * @example
+ * ```ts
+ * const strategy = new HierarchicalAccessStrategy();
+ * strategy.useCan({ id: 1, roles: ["editor"] }, "content:create"); // true
+ * ```
+ */
+export class HierarchicalAccessStrategy {
+    /** Active registry, keyed by role slug. Starts as the default set. */
+    registry;
+    constructor() {
+        this.registry = new Map(DEFAULT_ROLES.map((role) => [role.slug, role]));
+    }
+    useDefinitionFor(role) {
+        const definition = this.registry.get(role);
+        if (!definition) {
+            throw new Error(`Unknown access role: ${role}`);
+        }
+        return definition;
+    }
+    /**
+     * Effective capabilities of a role: its own plus every less-privileged role's.
+     *
+     * @example
+     * ```ts
+     * useCapabilitiesFor("author"); // content:create, content:edit:own, ..., conversations:use
+     * useCapabilitiesFor("guest");  // []
+     * ```
+     */
+    useCapabilitiesFor(role) {
+        const rank = ROLE_RANK[this.useDefinitionFor(role).slug];
+        const capabilities = new Set();
+        for (const definition of this.registry.values()) {
+            if (ROLE_RANK[definition.slug] >= rank) {
+                for (const capability of definition.capabilities) {
+                    capabilities.add(capability);
+                }
+            }
+        }
+        return [...capabilities];
+    }
+    /**
+     * Registers (or replaces) a role definition. Use it to extend a built-in
+     * role's capabilities, e.g. grant `content:create` to `member`. The definition
+     * is copied, so mutating the caller's object afterwards has no effect.
+     */
+    useRegisterRole(definition) {
+        this.registry.set(definition.slug, Object.freeze(useCopy(definition)));
+    }
+    /** Restores the built-in role registry (mainly for tests). */
+    useResetRoles() {
+        this.registry.clear();
+        for (const role of DEFAULT_ROLES) {
+            this.registry.set(role.slug, role);
+        }
+    }
+    /** Lists every registered role definition. Returns copies, not live state. */
+    useRoles() {
+        return [...this.registry.values()]
+            .sort((a, b) => ROLE_RANK[a.slug] - ROLE_RANK[b.slug])
+            .map(useCopy);
+    }
+    /** Exact role membership - no hierarchy involved. */
+    useHasRole(subject, role) {
+        return subject.roles.includes(role);
+    }
+    /**
+     * Whether the subject may perform a capability. Any of the subject's roles
+     * granting the capability (directly or by inheritance) is enough.
+     *
+     * @example
+     * ```ts
+     * useCan({ id: 1, roles: ["author"] }, "content:publish"); // false
+     * useCan({ id: 1, roles: ["author"] }, "content:create");  // true
+     * useCan({ id: 2, roles: ["editor"] }, "content:create");  // true (inherits author)
+     * useCan({ id: 3, roles: [] }, "conversations:use");       // false
+     * ```
+     */
+    useCan(subject, capability) {
+        return subject.roles.some((role) => this.useCapabilitiesFor(role).includes(capability));
+    }
+}
+/**
+ * Estrategia estricta: sólo verifica capacidades declaradas explícitamente
+ * en el rol del sujeto, sin her jerarquía. Útil cuando cada rol debe
+ * declarar todo lo que puede hacer.
+ *
+ * @example
+ * ```ts
+ * const access = new AccessService(new FlatAccessStrategy());
+ * // "editor" ya NO hereda las capacidades de "author"
+ * access.useCan({ id: 1, roles: ["editor"] }, "content:create"); // false
+ * ```
+ */
+export class FlatAccessStrategy {
+    registry;
+    constructor() {
+        this.registry = new Map(DEFAULT_ROLES.map((role) => [role.slug, role]));
+    }
+    useCapabilitiesFor(role) {
+        const definition = this.registry.get(role);
+        return definition ? [...definition.capabilities] : [];
+    }
+    useRegisterRole(definition) {
+        this.registry.set(definition.slug, Object.freeze(useCopy(definition)));
+    }
+    useResetRoles() {
+        this.registry.clear();
+        for (const role of DEFAULT_ROLES) {
+            this.registry.set(role.slug, role);
+        }
+    }
+    useRoles() {
+        return [...this.registry.values()].map(useCopy);
+    }
+    useHasRole(subject, role) {
+        return subject.roles.includes(role);
+    }
+    useCan(subject, capability) {
+        return subject.roles.some((role) => this.useCapabilitiesFor(role).includes(capability));
+    }
 }
+/* -------------------------------------------------------------------------- */
+/* Context (Singleton facade)                                                 */
+/* -------------------------------------------------------------------------- */
+/**
+ * AccessService - Singleton facade con Strategy Pattern.
+ *
+ * Centraliza el control de acceso (roles y capacidades) delegando el
+ * algoritmo concreto en una {@link IAccessStrategy} intercambiable.
+ * Por defecto usa {@link HierarchicalAccessStrategy}.
+ *
+ * @example
+ * ```ts
+ * // Uso con la estrategia por defecto (jerárquica)
+ * AccessService.getInstance().useCan({ id: 1, roles: ["admin"] }, "members:manage");
+ *
+ * // Cambiar a estrategia plana en runtime
+ * AccessService.getInstance().useSetStrategy(new FlatAccessStrategy());
+ * ```
+ */
+export class AccessService {
+    static instance;
+    strategy;
+    /**
+     * Constructor privado - enforce singleton.
+     * @param strategy - Estrategia a inyectar (opcional).
+     */
+    constructor(strategy) {
+        this.strategy = strategy ?? new HierarchicalAccessStrategy();
+    }
+    /**
+     * Obtiene la instancia única del AccessService (Singleton).
+     *
+     * @returns La instancia única de {@link AccessService}.
+     */
+    static getInstance() {
+        if (!AccessService.instance) {
+            AccessService.instance = new AccessService();
+        }
+        return AccessService.instance;
+    }
+    /**
+     * Crea una instancia NO-singleton con una estrategia específica.
+     * Útil para tests o para aislar varios contextos de acceso.
+     *
+     * @param strategy - Estrategia a inyectar.
+     * @returns Una nueva instancia de {@link AccessService}.
+     *
+     * @example
+     * ```ts
+     * const flatAccess = AccessService.create(new FlatAccessStrategy());
+     * ```
+     */
+    static create(strategy) {
+        return new AccessService(strategy);
+    }
+    /**
+     * Intercambia la estrategia de acceso en runtime (Strategy Pattern).
+     *
+     * @param strategy - La nueva estrategia a utilizar.
+     */
+    useSetStrategy(strategy) {
+        this.strategy = strategy;
+    }
+    /** Returns the currently active strategy. */
+    useGetStrategy() {
+        return this.strategy;
+    }
+    /**
+     * Effective capabilities of a role (delegado a la estrategia activa).
+     */
+    useCapabilitiesFor(role) {
+        return this.strategy.useCapabilitiesFor(role);
+    }
+    /**
+     * Registers (or replaces) a role definition (delegado a la estrategia activa).
+     */
+    useRegisterRole(definition) {
+        this.strategy.useRegisterRole(definition);
+    }
+    /** Restores the built-in role registry (delegado a la estrategia activa). */
+    useResetRoles() {
+        this.strategy.useResetRoles();
+    }
+    /** Lists every registered role definition (delegado a la estrategia activa). */
+    useRoles() {
+        return this.strategy.useRoles();
+    }
+    /** Exact role membership - no hierarchy involved. */
+    useHasRole(subject, role) {
+        return this.strategy.useHasRole(subject, role);
+    }
+    /**
+     * Whether the subject may perform a capability (delegado a la estrategia activa).
+     */
+    useCan(subject, capability) {
+        return this.strategy.useCan(subject, capability);
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* Wrappers (backward compatibility)                                          */
+/* -------------------------------------------------------------------------- */
 /**
  * Effective capabilities of a role: its own plus every less-privileged role's.
  *
  * @example
  * ```ts
- * useCapabilitiesFor("author"); // content:create, content:edit:own, …, conversations:use
+ * useCapabilitiesFor("author"); // content:create, content:edit:own, ..., conversations:use
  * useCapabilitiesFor("guest");  // []
  * ```
  */
 export function useCapabilitiesFor(role) {
-    const rank = ROLE_RANK[useDefinitionFor(role).slug];
-    const capabilities = new Set();
-    for (const definition of registry.values()) {
-        if (ROLE_RANK[definition.slug] >= rank) {
-            for (const capability of definition.capabilities) {
-                capabilities.add(capability);
-            }
-        }
-    }
-    return [...capabilities];
+    return AccessService.getInstance().useCapabilitiesFor(role);
 }
 /**
  * Registers (or replaces) a role definition. Use it to extend a built-in
- * role's capabilities, e.g. grant `content:create` to `member`. The definition
- * is copied, so mutating the caller's object afterwards has no effect.
+ * role's capabilities, e.g. grant `content:create` to `member`.
  */
 export function useRegisterRole(definition) {
-    registry.set(definition.slug, Object.freeze(useCopy(definition)));
+    AccessService.getInstance().useRegisterRole(definition);
 }
 /** Restores the built-in role registry (mainly for tests). */
 export function useResetRoles() {
-    registry.clear();
-    for (const role of DEFAULT_ROLES) {
-        registry.set(role.slug, role);
-    }
+    AccessService.getInstance().useResetRoles();
 }
 /** Lists every registered role definition. Returns copies, not live state. */
 export function useRoles() {
-    return [...registry.values()].sort((a, b) => ROLE_RANK[a.slug] - ROLE_RANK[b.slug]).map(useCopy);
+    return AccessService.getInstance().useRoles();
 }
-/** Exact role membership — no hierarchy involved. */
+/** Exact role membership - no hierarchy involved. */
 export function useHasRole(subject, role) {
-    return subject.roles.includes(role);
+    return AccessService.getInstance().useHasRole(subject, role);
 }
 /**
  * Whether the subject may perform a capability. Any of the subject's roles
@@ -106,6 +316,6 @@ export function useHasRole(subject, role) {
  * ```
  */
 export function useCan(subject, capability) {
-    return subject.roles.some((role) => useCapabilitiesFor(role).includes(capability));
+    return AccessService.getInstance().useCan(subject, capability);
 }
 //# sourceMappingURL=access.service.js.map

package/dist/core/services/access.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"access.service.js","sourceRoot":"","sources":["../../../src/core/services/access.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"access.service.js","sourceRoot":"","sources":["../../../src/core/services/access.service.ts"],"names":[],"mappings":"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"}

package/dist/core/services/agent.service.d.ts

@@ -1,4 +1,4 @@
-import type { AgentResult, AgentRunOptions, AiChatOptions, AiMessage, AiProviderConfig, AiResult } from "../../types/index.js";
+import type { AgentResult, AgentRunOptions, AiChatOptions, AiMessage, AiProviderConfig, AiResult, AiTool, AiToolCall } from "../../types/index.js";
 /** Default endpoint for Alibaba Cloud Model Studio (DashScope) compatible mode. */
 export declare const KITT_BASE_URL = "https://dashscope-intl.aliyuncs.com/compatible-mode/v1";
 /** Default model for the Kitt assistant preset. */
@@ -7,11 +7,183 @@ export declare const KITT_DEFAULT_MODEL = "qwen3.8-max";
 export declare const KITT_SYSTEM_PROMPT = "You are Kitt, a helpful assistant. Answer clearly and concisely.";
 /** Reusable preset (base URL + model) for the Kitt assistant. */
 export declare const kittPreset: Pick<AiProviderConfig, "baseUrl" | "model">;
+/** Shape of a `/chat/completions` response. */
+interface ChatCompletionResponse {
+    choices?: Array<{
+        message?: {
+            content?: string | null;
+            tool_calls?: AiToolCall[];
+        };
+        finish_reason?: string | null;
+    }>;
+    error?: {
+        message?: string;
+    };
+}
+/** Request options shared by chat and agent calls. */
+interface RequestOptions {
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    signal?: AbortSignal;
+    tools?: AiTool[];
+}
 /**
- * Registers the AI provider for the Kitt assistant.
+ * Estrategia de proveedor AI - Strategy Pattern.
+ *
+ * Define el contrato que toda implementación de proveedor de completions debe
+ * cumplir. El {@link AgentService} delega la llamada HTTP en una estrategia
+ * concreta, permitiendo intercambiar proveedores (DashScope, OpenAI,
+ * self-hosted, mock en tests) sin tocar el bucle del agente.
+ */
+export interface IAiProviderStrategy {
+    /**
+     * Performs a single `chat/completions` request against the provider.
+     *
+     * @param config - Provider configuration (baseUrl, model, apiKey).
+     * @param messages - Conversation messages.
+     * @param options - Sampling options, tools and abort signal.
+     * @returns The parsed provider response.
+     * @throws On non-2xx responses or transport failures.
+     */
+    requestCompletion(config: AiProviderConfig, messages: AiMessage[], options: RequestOptions): Promise<ChatCompletionResponse>;
+}
+/**
+ * Estrategia por defecto: proveedor compatible con OpenAI
+ * (`POST /chat/completions` con Bearer token). Cubre DashScope en modo
+ * compatible, OpenAI, Azure OpenAI y la mayoría de endpoints self-hosted.
+ *
+ * @example
+ * ```ts
+ * const strategy = new OpenAiCompatibleStrategy();
+ * const response = await strategy.requestCompletion(config, messages, {});
+ * ```
+ */
+export declare class OpenAiCompatibleStrategy implements IAiProviderStrategy {
+    /**
+     * Performs a raw `chat/completions` request against the provider.
+     * Throws {@link AiHttpError} on non-2xx responses.
+     */
+    requestCompletion(config: AiProviderConfig, messages: AiMessage[], options: RequestOptions): Promise<ChatCompletionResponse>;
+}
+/**
+ * AgentService - Singleton facade con Strategy Pattern.
  *
- * `apiKey` falls back to `process.env.DASHSCOPE_API_KEY`; `baseUrl`, `model`
- * and `systemPrompt` fall back to the {@link kittPreset} defaults.
+ * Centraliza el registro del proveedor AI y el bucle de completions,
+ * delegando la llamada HTTP en una {@link IAiProviderStrategy}
+ * intercambiable. Por defecto usa {@link OpenAiCompatibleStrategy}.
+ *
+ * @example
+ * ```ts
+ * // Configurar el proveedor
+ * AgentService.getInstance().useInitAgent({ apiKey: process.env.DASHSCOPE_API_KEY });
+ *
+ * // Cambiar de estrategia en runtime (p. ej. un mock en tests)
+ * AgentService.getInstance().useSetStrategy(new OpenAiCompatibleStrategy());
+ * ```
+ */
+export declare class AgentService {
+    private static instance;
+    private provider;
+    private strategy;
+    /**
+     * Constructor privado - enforce singleton.
+     * @param strategy - Estrategia de proveedor a inyectar (opcional).
+     */
+    private constructor();
+    /**
+     * Obtiene la instancia única del AgentService (Singleton).
+     *
+     * @returns La instancia única de {@link AgentService}.
+     */
+    static getInstance(): AgentService;
+    /**
+     * Crea una instancia NO-singleton con una estrategia específica.
+     * Útil para tests o para aislar varios proveedores.
+     *
+     * @param strategy - Estrategia a inyectar.
+     * @returns Una nueva instancia de {@link AgentService}.
+     */
+    static create(strategy?: IAiProviderStrategy): AgentService;
+    /**
+     * Intercambia la estrategia de proveedor en runtime (Strategy Pattern).
+     *
+     * @param strategy - La nueva estrategia a utilizar.
+     */
+    useSetStrategy(strategy: IAiProviderStrategy): void;
+    /** Returns the currently active provider strategy. */
+    useGetStrategy(): IAiProviderStrategy;
+    /** Retrieves the configured provider or throws. */
+    private useGetProvider;
+    /**
+     * Registers the AI provider for the Kitt assistant.
+     *
+     * `apiKey` falls back to `process.env.DASHSCOPE_API_KEY`; `baseUrl`, `model`
+     * and `systemPrompt` fall back to the {@link kittPreset} defaults.
+     *
+     * @param config - Partial provider configuration.
+     *
+     * @example
+     * ```ts
+     * import { useInitAgent } from "katanakit-js";
+     *
+     * useInitAgent({
+     *   apiKey: process.env.DASHSCOPE_API_KEY,
+     *   model: "qwen3.8-max",
+     * });
+     * ```
+     */
+    useInitAgent(config?: Partial<AiProviderConfig>): void;
+    /**
+     * Sends a single chat completion and returns the assistant text as a Safe Result.
+     *
+     * Use this for review / questioning (single-shot). For autonomous multi-step
+     * work with tools, use {@link useRunAgent}.
+     *
+     * @param messages - Conversation messages (a system prompt is prepended if absent).
+     * @param options - Optional completion options.
+     * @returns A `AiResult` with the assistant text.
+     *
+     * @example
+     * ```ts
+     * import { useChat } from "katanakit-js";
+     *
+     * const result = await useChat([
+     *   { role: "user", content: "Summarize the benefits of solar energy in three bullet points." },
+     * ]);
+     * if (result.ok) console.log(result.data);
+     * ```
+     */
+    useChat(messages: AiMessage[], options?: AiChatOptions): Promise<AiResult<string>>;
+    /**
+     * Runs the tool-calling agent loop against a goal until it emits a final
+     * answer or exhausts `maxSteps`.
+     *
+     * @param goal - The natural-language objective.
+     * @param options - Tools, step budget and completion options.
+     * @returns An `AgentResult` with the final message and executed steps.
+     *
+     * @example
+     * ```ts
+     * import { useRunAgent } from "katanakit-js";
+     *
+     * const result = await useRunAgent("Fix the type errors reported by tsc", {
+     *   tools: [
+     *     {
+     *       name: "runCommand",
+     *       description: "Runs a shell command and returns its output",
+     *       parameters: { type: "object", properties: { command: { type: "string" } } },
+     *       execute: (input) => shell.run(input.command),
+     *     },
+     *   ],
+     *   maxSteps: 12,
+     * });
+     * ```
+     */
+    useRunAgent(goal: string, options?: AgentRunOptions): Promise<AgentResult>;
+}
+/**
+ * Registers the AI provider for the Kitt assistant.
  *
  * @param config - Partial provider configuration.
  *
@@ -19,30 +191,22 @@ export declare const kittPreset: Pick<AiProviderConfig, "baseUrl" | "model">;
  * ```ts
  * import { useInitAgent } from "katanakit-js";
  *
- * useInitAgent({
- *   apiKey: process.env.DASHSCOPE_API_KEY,
- *   model: "qwen3.8-max",
- * });
+ * useInitAgent({ apiKey: process.env.DASHSCOPE_API_KEY });
  * ```
  */
 export declare function useInitAgent(config?: Partial<AiProviderConfig>): void;
 /**
  * Sends a single chat completion and returns the assistant text as a Safe Result.
  *
- * Use this for review / questioning (single-shot). For autonomous multi-step
- * work with tools, use {@link useRunAgent}.
- *
  * @param messages - Conversation messages (a system prompt is prepended if absent).
  * @param options - Optional completion options.
- * @returns A {@link AiResult} with the assistant text.
+ * @returns An `AiResult` with the assistant text.
  *
  * @example
  * ```ts
  * import { useChat } from "katanakit-js";
  *
- * const result = await useChat([
- *   { role: "user", content: "Summarize the benefits of solar energy in three bullet points." },
- * ]);
+ * const result = await useChat([{ role: "user", content: "Hello" }]);
  * if (result.ok) console.log(result.data);
  * ```
  */
@@ -53,24 +217,15 @@ export declare function useChat(messages: AiMessage[], options?: AiChatOptions):
  *
  * @param goal - The natural-language objective.
  * @param options - Tools, step budget and completion options.
- * @returns An {@link AgentResult} with the final message and executed steps.
+ * @returns An `AgentResult` with the final message and executed steps.
  *
  * @example
  * ```ts
  * import { useRunAgent } from "katanakit-js";
  *
- * const result = await useRunAgent("Fix the type errors reported by tsc", {
- *   tools: [
- *     {
- *       name: "runCommand",
- *       description: "Runs a shell command and returns its output",
- *       parameters: { type: "object", properties: { command: { type: "string" } } },
- *       execute: (input) => shell.run(input.command),
- *     },
- *   ],
- *   maxSteps: 12,
- * });
+ * const result = await useRunAgent("Fix the type errors reported by tsc");
  * ```
  */
 export declare function useRunAgent(goal: string, options?: AgentRunOptions): Promise<AgentResult>;
+export {};
 //# sourceMappingURL=agent.service.d.ts.map

package/dist/core/services/agent.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.service.d.ts","sourceRoot":"","sources":["../../../src/core/services/agent.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,WAAW,EACX,eAAe,EAEf,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,QAAQ,EAGR,MAAM,sBAAsB,CAAC;AAE9B,mFAAmF;AACnF,eAAO,MAAM,aAAa,2DAA2D,CAAC;AAEtF,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAEhD,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,qEACoC,CAAC;AAEpE,iEAAiE;AACjE,eAAO,MAAM,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,OAAO,CAGlE,CAAC;AAgLF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAE,OAAO,CAAC,gBAAgB,CAAM,GAAG,IAAI,CAiBzE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,OAAO,CAC5B,QAAQ,EAAE,SAAS,EAAE,EACrB,OAAO,GAAE,aAAkB,GACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAuB3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,WAAW,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,eAAoB,GAC3B,OAAO,CAAC,WAAW,CAAC,CA4EtB"}
+{"version":3,"file":"agent.service.d.ts","sourceRoot":"","sources":["../../../src/core/services/agent.service.ts"],"names":[],"mappings":"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"}