@superblocksteam/vite-plugin-file-sync 1.99.99-next.2 → 2.0.0-SNAPSHOT.84af65cd215b6ca1

package/dist/ai-service/agent/tools2/entity-permissions.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Entity permission management for access control.
+ *
+ * Provides a generalized system for tracking user approvals for accessing
+ * specific entities (e.g., integrations, files, APIs). This enables granular
+ * per-entity access control where users can approve access to specific
+ * resources rather than blanket permissions.
+ */
+import type { AiEntityType, AiToolPermission } from "@superblocksteam/library-shared/types";
+/**
+ * Permission key components for scoping.
+ * Array of strings that identify the scope (e.g., ["toolName"] or ["category", "readonly"]).
+ */
+export type PermissionKey = string[];
+/**
+ * Formatted scope string for storage.
+ * Created by joining ToolPermissionKey components with a delimiter.
+ */
+export type PermissionScope = string;
+/**
+ * Strategy for determining how permissions are scoped by tool.
+ *
+ * Different strategies enable different granularities:
+ * - Per-tool: Each tool requires separate approval
+ * - Per-category: All tools in a category share approvals
+ * - Per-access: Separate read/write permissions
+ */
+export declare abstract class PermissionKeyStrategy {
+    /**
+     * Generate permission key components for a tool.
+     *
+     * @param tool - Tool to generate key for
+     * @returns Array of key components
+     */
+    abstract getPermissionKey(permission: AiToolPermission, input: any): PermissionKey;
+    /**
+     * Format permission key into storage scope string.
+     *
+     * Default implementation joins components with ':' delimiter.
+     *
+     * @param key - Permission key components
+     * @returns Formatted scope string
+     */
+    formatScope(key: PermissionKey): PermissionScope;
+}
+/**
+ * Action-based strategy: scope permissions by action type (read/write).
+ *
+ * Groups tools by the action they perform rather than their specific name.
+ * This allows users to approve "read" or "write" operations on entities,
+ * and all tools performing that action will share the approval.
+ *
+ * - readOnly tools → "read" scope
+ * - Non-readOnly tools → "write" scope
+ */
+export declare class ActionBasedPermissionKeyStrategy extends PermissionKeyStrategy {
+    getPermissionKey(permission: AiToolPermission, _input?: any): PermissionKey;
+}
+/**
+ * Store for tracking entity-level permissions.
+ *
+ * This interface abstracts the storage mechanism, allowing different
+ * implementations (session-based, persistent, etc.) to be swapped out
+ * without changing the access control logic.
+ *
+ * Permissions are scoped by tool permission scope strings, enabling
+ * granular control (e.g., per-tool, per-category, etc.).
+ */
+export interface EntityPermissionStore {
+    /**
+     * Check if a tool call has been approved for a specific input and tool name.
+     *
+     * @param toolName - The name of the tool
+     * @param input - The input of the tool call
+     * @returns True if the tool call has been approved for this input and tool name
+     */
+    isToolCallApproved(toolName: string, input: any): boolean;
+    /**
+     * Approve a tool call for a specific input and tool name.
+     *
+     * @param toolName - The name of the tool
+     * @param input - The input of the tool call
+     */
+    approveToolCall(toolName: string, input: any): void;
+    /**
+     * Revoke a tool call.
+     *
+     * @param toolName - The name of the tool
+     * @param input - The input of the tool call
+     */
+    revokeToolCall(toolName: string, input: any): void;
+    /**
+     * Check if access to a specific entity has been approved for a scope.
+     *
+     * @param entityType - The type of entity to check
+     * @param entityId - The unique identifier of the entity
+     * @param scope - Permission scope (e.g., "toolName", "category:read")
+     * @returns True if the entity has been approved for this scope
+     */
+    isApproved(entityType: AiEntityType, entityId: string | undefined, scope: PermissionScope): boolean;
+    /**
+     * Approve access to a specific entity for a scope.
+     *
+     * Once approved, future permission checks for this entity and scope will
+     * return true until explicitly revoked or the store is cleared.
+     *
+     * @param entityType - The type of entity to approve
+     * @param entityId - The unique identifier of the entity
+     * @param scope - Permission scope (e.g., "toolName", "category:read")
+     */
+    approve(entityType: AiEntityType, entityId: string | undefined, scope: PermissionScope): void;
+    /**
+     * Revoke access to a specific entity for a scope.
+     *
+     * Removes the approval for this entity and scope, requiring re-approval
+     * for future access attempts.
+     *
+     * @param entityType - The type of entity to revoke
+     * @param entityId - The unique identifier of the entity
+     * @param scope - Permission scope (e.g., "toolName", "category:read")
+     */
+    revoke(entityType: AiEntityType, entityId: string | undefined, scope: PermissionScope): void;
+    /**
+     * Clear all entity approvals.
+     *
+     * Removes all stored approvals across all entity types and scopes.
+     */
+    clear(): void;
+    /**
+     * Get all approved entity IDs for a specific entity type and optional scope.
+     *
+     * Useful for debugging, inspection, and UI display of approved entities.
+     *
+     * @param entityType - The type of entity to list approvals for
+     * @param scope - Optional permission scope. If provided, returns only approvals
+     *                for that scope. If omitted, returns all approved entities
+     *                across all scopes.
+     * @returns Array of approved entity IDs for the given type (and scope)
+     */
+    getApproved(entityType: AiEntityType, scope?: PermissionScope): string[];
+}
+/**
+ * Session-scoped implementation of entity permission store.
+ *
+ * Stores approvals in memory for the duration of the session.
+ * Approvals are lost when the session ends or the store is cleared.
+ *
+ * Permissions are scoped, allowing different tools/categories to have
+ * independent approval states for the same entity.
+ *
+ * This implementation is suitable for session-based permission tracking
+ * and can be replaced with a persistent implementation if needed.
+ */
+export declare class SessionEntityPermissionStore implements EntityPermissionStore {
+    private permissions;
+    private temporaryPermissions;
+    constructor();
+    isToolCallApproved(toolName: string, input: any): boolean;
+    approveToolCall(toolName: string, input: any): void;
+    revokeToolCall(toolName: string, input: any): void;
+    /**
+     * Check if access to a specific entity has been approved for a scope.
+     *
+     * @param entityType - The type of entity to check
+     * @param entityId - The unique identifier of the entity
+     * @param scope - Permission scope
+     * @returns True if the entity has been approved for this scope
+     */
+    isApproved(entityType: AiEntityType, entityId: string, scope: PermissionScope): boolean;
+    /**
+     * Approve access to a specific entity for a scope.
+     *
+     * @param entityType - The type of entity to approve
+     * @param entityId - The unique identifier of the entity
+     * @param scope - Permission scope
+     */
+    approve(entityType: AiEntityType, entityId: string, scope: PermissionScope): void;
+    /**
+     * Revoke access to a specific entity for a scope.
+     *
+     * @param entityType - The type of entity to revoke
+     * @param entityId - The unique identifier of the entity
+     * @param scope - Permission scope
+     */
+    revoke(entityType: AiEntityType, entityId: string | undefined, scope: PermissionScope): void;
+    /**
+     * Clear all entity approvals across all scopes.
+     */
+    clear(): void;
+    /**
+     * Get all approved entity IDs for a specific entity type and optional scope.
+     *
+     * @param entityType - The type of entity to list approvals for
+     * @param scope - Optional permission scope. If provided, returns only approvals
+     *                for that scope. If omitted, returns all approved entities
+     *                across all scopes (deduplicated).
+     * @returns Array of approved entity IDs for the given type (and scope)
+     */
+    getApproved(entityType: AiEntityType, scope?: PermissionScope): string[];
+}
+//# sourceMappingURL=entity-permissions.d.ts.map

package/dist/ai-service/agent/tools2/entity-permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-permissions.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools2/entity-permissions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EACjB,MAAM,uCAAuC,CAAC;AAI/C;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,EAAE,CAAC;AAErC;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AAErC;;;;;;;GAOG;AACH,8BAAsB,qBAAqB;IACzC;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,CACvB,UAAU,EAAE,gBAAgB,EAC5B,KAAK,EAAE,GAAG,GACT,aAAa;IAEhB;;;;;;;OAOG;IACH,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,eAAe;CAGjD;AAED;;;;;;;;;GASG;AACH,qBAAa,gCAAiC,SAAQ,qBAAqB;IACzE,gBAAgB,CAAC,UAAU,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,aAAa;CAG5E;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC;IAC1D;;;;;OAKG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;IACpD;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;IACnD;;;;;;;OAOG;IACH,UAAU,CACR,UAAU,EAAE,YAAY,EACxB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC;IAEX;;;;;;;;;OASG;IACH,OAAO,CACL,UAAU,EAAE,YAAY,EACxB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,KAAK,EAAE,eAAe,GACrB,IAAI,CAAC;IAER;;;;;;;;;OASG;IACH,MAAM,CACJ,UAAU,EAAE,YAAY,EACxB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,KAAK,EAAE,eAAe,GACrB,IAAI,CAAC;IAER;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;;;;;;;;;OAUG;IACH,WAAW,CAAC,UAAU,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,eAAe,GAAG,MAAM,EAAE,CAAC;CAC1E;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,4BAA6B,YAAW,qBAAqB;IACxE,OAAO,CAAC,WAAW,CAAuD;IAC1E,OAAO,CAAC,oBAAoB,CAAgD;;IAO5E,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO;IAKzD,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAKnD,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAKlD;;;;;;;OAOG;IACH,UAAU,CACR,UAAU,EAAE,YAAY,EACxB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,eAAe,GACrB,OAAO;IASV;;;;;;OAMG;IACH,OAAO,CACL,UAAU,EAAE,YAAY,EACxB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,eAAe,GACrB,IAAI;IAgBP;;;;;;OAMG;IACH,MAAM,CACJ,UAAU,EAAE,YAAY,EACxB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,KAAK,EAAE,eAAe,GACrB,IAAI;IASP;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;;;;OAQG;IACH,WAAW,CAAC,UAAU,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,eAAe,GAAG,MAAM,EAAE;CAqBzE"}

package/dist/ai-service/agent/tools2/entity-permissions.js

@@ -0,0 +1,163 @@
+/**
+ * Entity permission management for access control.
+ *
+ * Provides a generalized system for tracking user approvals for accessing
+ * specific entities (e.g., integrations, files, APIs). This enables granular
+ * per-entity access control where users can approve access to specific
+ * resources rather than blanket permissions.
+ */
+import { getToolCallSignature } from "../../util/tool-signature.js";
+/**
+ * Strategy for determining how permissions are scoped by tool.
+ *
+ * Different strategies enable different granularities:
+ * - Per-tool: Each tool requires separate approval
+ * - Per-category: All tools in a category share approvals
+ * - Per-access: Separate read/write permissions
+ */
+export class PermissionKeyStrategy {
+    /**
+     * Format permission key into storage scope string.
+     *
+     * Default implementation joins components with ':' delimiter.
+     *
+     * @param key - Permission key components
+     * @returns Formatted scope string
+     */
+    formatScope(key) {
+        return key.join(":");
+    }
+}
+/**
+ * Action-based strategy: scope permissions by action type (read/write).
+ *
+ * Groups tools by the action they perform rather than their specific name.
+ * This allows users to approve "read" or "write" operations on entities,
+ * and all tools performing that action will share the approval.
+ *
+ * - readOnly tools → "read" scope
+ * - Non-readOnly tools → "write" scope
+ */
+export class ActionBasedPermissionKeyStrategy extends PermissionKeyStrategy {
+    getPermissionKey(permission, _input) {
+        return [permission.permissionType];
+    }
+}
+/**
+ * Session-scoped implementation of entity permission store.
+ *
+ * Stores approvals in memory for the duration of the session.
+ * Approvals are lost when the session ends or the store is cleared.
+ *
+ * Permissions are scoped, allowing different tools/categories to have
+ * independent approval states for the same entity.
+ *
+ * This implementation is suitable for session-based permission tracking
+ * and can be replaced with a persistent implementation if needed.
+ */
+export class SessionEntityPermissionStore {
+    permissions;
+    temporaryPermissions; // key is tool call signature
+    constructor() {
+        this.permissions = new Map();
+        this.temporaryPermissions = new Map();
+    }
+    isToolCallApproved(toolName, input) {
+        const toolCallIdentifier = getToolCallSignature(toolName, input);
+        return this.temporaryPermissions.has(toolCallIdentifier);
+    }
+    approveToolCall(toolName, input) {
+        const toolCallIdentifier = getToolCallSignature(toolName, input);
+        this.temporaryPermissions.set(toolCallIdentifier, { input, toolName });
+    }
+    revokeToolCall(toolName, input) {
+        const toolCallIdentifier = getToolCallSignature(toolName, input);
+        this.temporaryPermissions.delete(toolCallIdentifier);
+    }
+    /**
+     * Check if access to a specific entity has been approved for a scope.
+     *
+     * @param entityType - The type of entity to check
+     * @param entityId - The unique identifier of the entity
+     * @param scope - Permission scope
+     * @returns True if the entity has been approved for this scope
+     */
+    isApproved(entityType, entityId, scope) {
+        const scopedPermissions = this.permissions.get(entityType);
+        if (!scopedPermissions) {
+            return false;
+        }
+        const approved = scopedPermissions.get(scope);
+        return approved?.has(entityId ?? "*") ?? false;
+    }
+    /**
+     * Approve access to a specific entity for a scope.
+     *
+     * @param entityType - The type of entity to approve
+     * @param entityId - The unique identifier of the entity
+     * @param scope - Permission scope
+     */
+    approve(entityType, entityId, scope) {
+        let scopedPermissions = this.permissions.get(entityType);
+        if (!scopedPermissions) {
+            scopedPermissions = new Map();
+            this.permissions.set(entityType, scopedPermissions);
+        }
+        let approved = scopedPermissions.get(scope);
+        if (!approved) {
+            approved = new Set();
+            scopedPermissions.set(scope, approved);
+        }
+        approved.add(entityId ?? "*");
+    }
+    /**
+     * Revoke access to a specific entity for a scope.
+     *
+     * @param entityType - The type of entity to revoke
+     * @param entityId - The unique identifier of the entity
+     * @param scope - Permission scope
+     */
+    revoke(entityType, entityId, scope) {
+        const scopedPermissions = this.permissions.get(entityType);
+        if (!scopedPermissions) {
+            return;
+        }
+        const approved = scopedPermissions.get(scope);
+        approved?.delete(entityId ?? "*");
+    }
+    /**
+     * Clear all entity approvals across all scopes.
+     */
+    clear() {
+        this.permissions.clear();
+    }
+    /**
+     * Get all approved entity IDs for a specific entity type and optional scope.
+     *
+     * @param entityType - The type of entity to list approvals for
+     * @param scope - Optional permission scope. If provided, returns only approvals
+     *                for that scope. If omitted, returns all approved entities
+     *                across all scopes (deduplicated).
+     * @returns Array of approved entity IDs for the given type (and scope)
+     */
+    getApproved(entityType, scope) {
+        const scopedPermissions = this.permissions.get(entityType);
+        if (!scopedPermissions) {
+            return [];
+        }
+        // If scope provided, return only that scope's entities
+        if (scope !== undefined) {
+            const approved = scopedPermissions.get(scope);
+            return approved ? Array.from(approved) : [];
+        }
+        // No scope provided - return all entities across all scopes (deduplicated)
+        const allEntities = new Set();
+        for (const approved of scopedPermissions.values()) {
+            for (const entityId of approved) {
+                allEntities.add(entityId ?? "*");
+            }
+        }
+        return Array.from(allEntities);
+    }
+}
+//# sourceMappingURL=entity-permissions.js.map

package/dist/ai-service/agent/tools2/entity-permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-permissions.js","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools2/entity-permissions.ts"],"names":[],"mappings":"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"}

package/dist/ai-service/agent/tools2/example.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Example usage of the Tool Registry system.
+ *
+ * This file demonstrates:
+ * - Creating tool factories
+ * - Registering tools
+ * - Setting up access control
+ * - Executing tools with permissions
+ */
+import { ToolRegistry } from "./index.js";
+export declare function setupExampleRegistry(): ToolRegistry;
+export declare function exampleUsage(): Promise<void>;
+//# sourceMappingURL=example.d.ts.map

package/dist/ai-service/agent/tools2/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools2/example.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EACL,YAAY,EAMb,MAAM,YAAY,CAAC;AA+EpB,wBAAgB,oBAAoB,iBAuDnC;AAMD,wBAAsB,YAAY,kBAuCjC"}

package/dist/ai-service/agent/tools2/example.js

@@ -0,0 +1,151 @@
+/**
+ * Example usage of the Tool Registry system.
+ *
+ * This file demonstrates:
+ * - Creating tool factories
+ * - Registering tools
+ * - Setting up access control
+ * - Executing tools with permissions
+ */
+import { z } from "zod";
+import { ToolRegistry, PermissionLevel, promptForTools, requireRole, createToolFactory, ToolCategory, } from "./index.js";
+// ============================================================================
+// Example Tool: Add Event
+// ============================================================================
+const addEventToolFactory = createToolFactory("add-event", (_deps) => {
+    // This would typically import from your existing tool
+    const PayloadSchema = z
+        .record(z.string(), z.enum(["string", "number", "boolean"]))
+        .optional();
+    return {
+        description: "Add a new event to the scope",
+        category: ToolCategory.COMPONENT,
+        defaultPermission: PermissionLevel.ALLOW,
+        inputSchema: z.object({
+            pageScopeId: z.string(),
+            entityName: z.string(),
+            payload: PayloadSchema,
+        }),
+        execute: async (input) => {
+            // Implementation here
+            console.log("Adding event:", input);
+            return {
+                success: true,
+                message: `Event ${input.entityName} added`,
+            };
+        },
+    };
+});
+// ============================================================================
+// Example Tool: Delete File (Destructive)
+// ============================================================================
+const deleteFileToolFactory = createToolFactory("delete-file", (_fileSystem) => ({
+    description: "Delete a file from the project",
+    category: ToolCategory.FILE,
+    defaultPermission: PermissionLevel.PROMPT, // Requires confirmation
+    inputSchema: z.object({
+        path: z.string(),
+    }),
+    execute: async (input) => {
+        // Implementation here
+        console.log("Deleting file:", input.path);
+        return {
+            success: true,
+            message: `File ${input.path} deleted`,
+        };
+    },
+}));
+// ============================================================================
+// Example Tool: Read File (Safe)
+// ============================================================================
+const readFileToolFactory = createToolFactory("read-file", (_fileSystem) => ({
+    description: "Read a file from the project",
+    category: ToolCategory.FILE,
+    defaultPermission: PermissionLevel.ALLOW,
+    inputSchema: z.object({
+        path: z.string(),
+    }),
+    execute: async (input) => {
+        console.log("Reading file:", input.path);
+        return {
+            content: "file contents here",
+        };
+    },
+}));
+// ============================================================================
+// Setup Example
+// ============================================================================
+export function setupExampleRegistry() {
+    const registry = new ToolRegistry();
+    // 1. Setup access control rules
+    //    Rules are evaluated in order, most restrictive wins
+    // Block tools for guest users
+    registry.addAccessRule(requireRole(["admin", "editor"], PermissionLevel.BLOCK));
+    // Prompt for destructive operations
+    registry.addAccessRule(promptForTools(/^delete-/));
+    // Or use a preset
+    // registry.addAccessRule(...presets.production());
+    // 2. Setup prompt handler
+    registry.setPromptHandler(async (tool, input, _permissions, context) => {
+        console.log(`\n=== User Confirmation Required ===`);
+        console.log(`Tool: ${tool.name}`);
+        // Use tool formatting methods if available
+        const actionName = tool.getActionName?.();
+        const formattedInput = await tool.formatInput?.(input);
+        if (actionName) {
+            console.log(`Action: ${actionName.future}`);
+        }
+        if (formattedInput) {
+            if (formattedInput.targets.length > 0) {
+                console.log(`Targets: ${formattedInput.targets.join(", ")}`);
+            }
+            if (formattedInput.summary) {
+                console.log(`Summary: ${formattedInput.summary}`);
+            }
+            if (formattedInput.details) {
+                console.log(`Details:\n${formattedInput.details}`);
+            }
+        }
+        else {
+            console.log(`Input:`, input);
+        }
+        console.log(`User: ${context.userId} (${context.userRole})`);
+        console.log(`===================================\n`);
+        return; // Mock: auto-approve for demo
+    });
+    // 3. Register and instantiate tools with dependencies
+    const mockDeps = {};
+    registry.register(addEventToolFactory, mockDeps);
+    registry.register(deleteFileToolFactory, mockDeps);
+    registry.register(readFileToolFactory, mockDeps);
+    return registry;
+}
+// ============================================================================
+// Usage Example
+// ============================================================================
+export async function exampleUsage() {
+    const registry = setupExampleRegistry();
+    // Example 1: Execute allowed tool
+    console.log("\n--- Example 1: Allowed tool ---");
+    const result1 = await registry.execute("read-file", { path: "/src/app.ts" }, { userId: "user-123", userRole: "admin" });
+    console.log("Result:", result1);
+    // Example 2: Execute tool requiring confirmation
+    console.log("\n--- Example 2: Tool requiring confirmation ---");
+    const result2 = await registry.execute("delete-file", { path: "/src/temp.ts" }, { userId: "user-123", userRole: "admin" });
+    console.log("Result:", result2);
+    // Example 3: Blocked tool (guest user)
+    console.log("\n--- Example 3: Blocked tool ---");
+    const result3 = await registry.execute("delete-file", { path: "/src/important.ts" }, { userId: "guest-456", userRole: "guest" });
+    console.log("Result:", result3);
+    // Example 4: Get all tools for AI SDK
+    console.log("\n--- Example 4: Get tools for AI SDK ---");
+    const tools = registry.getToolsRecord();
+    console.log("Available tools:", Object.keys(tools));
+    // Example 5: Get tool metadata
+    console.log("\n--- Example 5: Tool metadata ---");
+    const metadata = registry.getToolMetadata();
+    console.log("Tool metadata:", metadata);
+}
+// Uncomment to run examples:
+// exampleUsage();
+//# sourceMappingURL=example.js.map

package/dist/ai-service/agent/tools2/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools2/example.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E,MAAM,mBAAmB,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE;IACnE,sDAAsD;IACtD,MAAM,aAAa,GAAG,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;SAC3D,QAAQ,EAAE,CAAC;IAEd,OAAO;QACL,WAAW,EAAE,8BAA8B;QAC3C,QAAQ,EAAE,YAAY,CAAC,SAAS;QAChC,iBAAiB,EAAE,eAAe,CAAC,KAAK;QACxC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;YACvB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;YACtB,OAAO,EAAE,aAAa;SACvB,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvB,sBAAsB;YACtB,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;YACpC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,SAAS,KAAK,CAAC,UAAU,QAAQ;aAC3C,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,+EAA+E;AAC/E,0CAA0C;AAC1C,+EAA+E;AAE/E,MAAM,qBAAqB,GAAG,iBAAiB,CAC7C,aAAa,EACb,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAChB,WAAW,EAAE,gCAAgC;IAC7C,QAAQ,EAAE,YAAY,CAAC,IAAI;IAC3B,iBAAiB,EAAE,eAAe,CAAC,MAAM,EAAE,wBAAwB;IACnE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACvB,sBAAsB;QACtB,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,QAAQ,KAAK,CAAC,IAAI,UAAU;SACtC,CAAC;IACJ,CAAC;CACF,CAAC,CACH,CAAC;AAEF,+EAA+E;AAC/E,iCAAiC;AACjC,+EAA+E;AAE/E,MAAM,mBAAmB,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC3E,WAAW,EAAE,8BAA8B;IAC3C,QAAQ,EAAE,YAAY,CAAC,IAAI;IAC3B,iBAAiB,EAAE,eAAe,CAAC,KAAK;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACvB,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO;YACL,OAAO,EAAE,oBAAoB;SAC9B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC,CAAC;AAEJ,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,MAAM,UAAU,oBAAoB;IAClC,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IAEpC,gCAAgC;IAChC,yDAAyD;IAEzD,8BAA8B;IAC9B,QAAQ,CAAC,aAAa,CACpB,WAAW,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CACxD,CAAC;IAEF,oCAAoC;IACpC,QAAQ,CAAC,aAAa,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;IAEnD,kBAAkB;IAClB,mDAAmD;IAEnD,0BAA0B;IAC1B,QAAQ,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE;QACrE,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAElC,2CAA2C;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;QAC1C,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC;QAEvD,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,WAAW,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,cAAc,EAAE,CAAC;YACnB,IAAI,cAAc,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtC,OAAO,CAAC,GAAG,CAAC,YAAY,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;gBAC3B,OAAO,CAAC,GAAG,CAAC,YAAY,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC;YACpD,CAAC;YACD,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;gBAC3B,OAAO,CAAC,GAAG,CAAC,aAAa,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,SAAS,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;QACrD,OAAO,CAAC,8BAA8B;IACxC,CAAC,CAAC,CAAC;IAEH,sDAAsD;IACtD,MAAM,QAAQ,GAAG,EAAE,CAAC;IACpB,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;IACjD,QAAQ,CAAC,QAAQ,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;IAEjD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,QAAQ,GAAG,oBAAoB,EAAE,CAAC;IAExC,kCAAkC;IAClC,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CACpC,WAAW,EACX,EAAE,IAAI,EAAE,aAAa,EAAE,EACvB,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,CAC1C,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAEhC,iDAAiD;IACjD,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CACpC,aAAa,EACb,EAAE,IAAI,EAAE,cAAc,EAAE,EACxB,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,CAC1C,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAEhC,uCAAuC;IACvC,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CACpC,aAAa,EACb,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAC7B,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,CAC3C,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAEhC,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,QAAQ,CAAC,cAAc,EAAE,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAEpD,+BAA+B;IAC/B,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,QAAQ,CAAC,eAAe,EAAE,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED,6BAA6B;AAC7B,kBAAkB"}

package/dist/ai-service/agent/tools2/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Tool Registry System
+ *
+ * Provides a centralized registry for tools with:
+ * - Factory-based registration and instantiation
+ * - Access control middleware
+ * - User prompt handling
+ * - Type-safe tool definitions
+ */
+export type { Tool, ToolFactory, ToolExecutionResult, AccessControlContext, AccessControlRule, PromptHandler, EntityReference, } from "./types.js";
+export { PermissionLevel, ToolCategory, createToolFactory } from "./types.js";
+export type { EntityPermissionStore } from "./entity-permissions.js";
+export { SessionEntityPermissionStore, PermissionKeyStrategy, ActionBasedPermissionKeyStrategy, type PermissionScope, type PermissionKey, } from "./entity-permissions.js";
+export { ToolRegistry } from "./registry.js";
+export { blockTools, promptForTools, requireRole, combineRules, forTools, forCategory, presets, } from "./access-control.js";
+import { ToolRegistry } from "./registry.js";
+export declare const defaultRegistry: ToolRegistry;
+//# sourceMappingURL=index.d.ts.map

package/dist/ai-service/agent/tools2/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools2/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EACV,IAAI,EACJ,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG9E,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,gCAAgC,EAChC,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,EACL,UAAU,EACV,cAAc,EACd,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,OAAO,GACR,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,eAAO,MAAM,eAAe,cAAqB,CAAC"}

package/dist/ai-service/agent/tools2/index.js

@@ -0,0 +1,19 @@
+/**
+ * Tool Registry System
+ *
+ * Provides a centralized registry for tools with:
+ * - Factory-based registration and instantiation
+ * - Access control middleware
+ * - User prompt handling
+ * - Type-safe tool definitions
+ */
+export { PermissionLevel, ToolCategory, createToolFactory } from "./types.js";
+export { SessionEntityPermissionStore, PermissionKeyStrategy, ActionBasedPermissionKeyStrategy, } from "./entity-permissions.js";
+// Export registry
+export { ToolRegistry } from "./registry.js";
+// Export access control utilities
+export { blockTools, promptForTools, requireRole, combineRules, forTools, forCategory, presets, } from "./access-control.js";
+// Export singleton instance for convenience
+import { ToolRegistry } from "./registry.js";
+export const defaultRegistry = new ToolRegistry();
+//# sourceMappingURL=index.js.map

package/dist/ai-service/agent/tools2/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools2/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAI9E,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,gCAAgC,GAGjC,MAAM,yBAAyB,CAAC;AAEjC,kBAAkB;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,kCAAkC;AAClC,OAAO,EACL,UAAU,EACV,cAAc,EACd,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,OAAO,GACR,MAAM,qBAAqB,CAAC;AAE7B,4CAA4C;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,YAAY,EAAE,CAAC"}