@mastra/editor 0.0.0-auth-rbac-cms-20260211172515

package/dist/index.d.cts

@@ -0,0 +1,209 @@
+import { IMastraEditor, MastraEditorConfig, Mastra, Agent, StorageResolvedAgentType } from '@mastra/core';
+export { MastraEditorConfig } from '@mastra/core';
+import { RuleGroup, AgentInstructionBlock, PromptBlocksStorage, StorageCreatePromptBlockInput, StorageResolvedPromptBlockType, StorageUpdatePromptBlockInput, StorageListPromptBlocksInput, StorageListPromptBlocksOutput, StorageListPromptBlocksResolvedOutput } from '@mastra/core/storage';
+
+/**
+ * TemplateEngine: Simple variable interpolation for prompt block content.
+ *
+ * Supports:
+ *   {{variableName}}         - Direct variable substitution
+ *   {{nested.path.value}}    - Dot-notation path resolution
+ *   {{variable || 'default'}} - Fallback values (single or double quotes)
+ *
+ * Variables that cannot be resolved (and have no fallback) are left as-is.
+ */
+/**
+ * Renders a template string by interpolating variables from the given context.
+ *
+ * @param template - The template string with {{variable}} placeholders
+ * @param context - A key-value context object for variable resolution
+ * @returns The rendered string with variables replaced
+ */
+declare function renderTemplate(template: string, context: Record<string, unknown>): string;
+
+/**
+ * RuleEvaluator: Evaluates recursive RuleGroup conditions against a context object.
+ *
+ * Supports:
+ *   - Leaf rules with operators: equals, not_equals, contains, not_contains,
+ *     greater_than, less_than, greater_than_or_equal, less_than_or_equal,
+ *     in, not_in, exists, not_exists
+ *   - Recursive AND / OR grouping via RuleGroup
+ */
+
+/**
+ * Evaluates a RuleGroup (which may contain nested RuleGroups) against a context object.
+ *
+ * @param ruleGroup - The rule group to evaluate (AND/OR with nested conditions)
+ * @param context - The context object to evaluate against
+ * @returns true if the rule group passes, false otherwise
+ */
+declare function evaluateRuleGroup(ruleGroup: RuleGroup, context: Record<string, unknown>): boolean;
+
+/**
+ * InstructionBuilder: Resolves an array of AgentInstructionBlock items
+ * into a final instruction string.
+ *
+ * For each block:
+ *  - `{ type: 'text', content }` → render template with context
+ *  - `{ type: 'prompt_block_ref', id }` → fetch from storage, evaluate rules, render template
+ *  - `{ type: 'prompt_block', content, rules? }` → inline block, evaluate rules, render template
+ *
+ * Blocks that fail rule evaluation are excluded.
+ * Resolved text segments are joined with double newlines.
+ */
+
+interface InstructionBuilderDeps {
+    promptBlocksStorage: PromptBlocksStorage;
+}
+/**
+ * Resolves an array of instruction blocks into a final instruction string.
+ *
+ * @param blocks - Array of instruction block references (text, prompt_block_ref, or inline prompt_block)
+ * @param context - Runtime context for template interpolation and rule evaluation
+ * @param deps - Dependencies (storage)
+ * @returns The resolved instruction string
+ */
+declare function resolveInstructionBlocks(blocks: AgentInstructionBlock[], context: Record<string, unknown>, deps: InstructionBuilderDeps): Promise<string>;
+
+declare class MastraEditor implements IMastraEditor {
+    private logger?;
+    private mastra?;
+    constructor(config?: MastraEditorConfig);
+    /**
+     * Register this editor with a Mastra instance.
+     * This gives the editor access to Mastra's storage, tools, workflows, etc.
+     */
+    registerWithMastra(mastra: Mastra): void;
+    /**
+     * Get the agents storage domain from the Mastra storage.
+     */
+    private getAgentsStore;
+    /**
+     * Get the prompt blocks storage domain from the Mastra storage.
+     */
+    private getPromptBlocksStore;
+    /**
+     * Get a stored agent by its ID.
+     * Returns null when agent is not found. Returns an Agent instance by default,
+     * or raw StorageResolvedAgentType when raw option is true.
+     */
+    getStoredAgentById(id: string, options?: {
+        returnRaw?: false;
+        versionId?: string;
+        versionNumber?: number;
+    }): Promise<Agent | null>;
+    getStoredAgentById(id: string, options: {
+        returnRaw: true;
+        versionId?: string;
+        versionNumber?: number;
+    }): Promise<StorageResolvedAgentType | null>;
+    /**
+     * List all stored agents with page-based pagination.
+     */
+    listStoredAgents(options?: {
+        returnRaw?: false;
+        page?: number;
+        pageSize?: number;
+    }): Promise<{
+        agents: Agent[];
+        total: number;
+        page: number;
+        perPage: number;
+        hasMore: boolean;
+    }>;
+    listStoredAgents(options: {
+        returnRaw: true;
+        page?: number;
+        pageSize?: number;
+    }): Promise<{
+        agents: StorageResolvedAgentType[];
+        total: number;
+        page: number;
+        perPage: number;
+        hasMore: boolean;
+    }>;
+    /**
+     * Create a new prompt block with an initial version.
+     */
+    createPromptBlock(input: StorageCreatePromptBlockInput): Promise<StorageResolvedPromptBlockType>;
+    /**
+     * Get a prompt block by ID, resolved with its active version.
+     */
+    getPromptBlock(id: string): Promise<StorageResolvedPromptBlockType | null>;
+    /**
+     * Update a prompt block, creating a new version with the changes.
+     */
+    updatePromptBlock(input: StorageUpdatePromptBlockInput): Promise<StorageResolvedPromptBlockType>;
+    /**
+     * Delete a prompt block and all its versions.
+     */
+    deletePromptBlock(id: string): Promise<void>;
+    /**
+     * List prompt blocks with optional pagination and filtering.
+     */
+    listPromptBlocks(args?: StorageListPromptBlocksInput): Promise<StorageListPromptBlocksOutput>;
+    /**
+     * List prompt blocks resolved with their active version config.
+     */
+    listPromptBlocksResolved(args?: StorageListPromptBlocksInput): Promise<StorageListPromptBlocksResolvedOutput>;
+    /**
+     * Preview the resolved instructions for a given set of instruction blocks and context.
+     * Useful for UI preview endpoints.
+     */
+    previewInstructions(blocks: AgentInstructionBlock[], context: Record<string, unknown>): Promise<string>;
+    /**
+     * Clear the stored agent cache for a specific agent ID, or all cached agents.
+     * When clearing a specific agent, also removes it from Mastra's agent registry
+     * so that fresh data is loaded on next access.
+     */
+    clearStoredAgentCache(agentId?: string): void;
+    /**
+     * Create an Agent instance from stored configuration.
+     * Resolves all stored references (tools, workflows, agents, memory, scorers)
+     * and registers the agent with the Mastra instance.
+     */
+    private createAgentFromStoredConfig;
+    /**
+     * Resolve stored instructions to a value compatible with the Agent constructor.
+     * - `string` → pass through as-is (backward compatible)
+     * - `AgentInstructionBlock[]` → wrap in a DynamicArgument function that resolves at runtime
+     * - `undefined` → return undefined
+     */
+    private resolveStoredInstructions;
+    /**
+     * Resolve stored tool IDs to actual tool instances from Mastra's registry.
+     */
+    private resolveStoredTools;
+    /**
+     * Resolve stored workflow IDs to actual workflow instances from Mastra's registry.
+     */
+    private resolveStoredWorkflows;
+    /**
+     * Resolve stored agent IDs to actual agent instances from Mastra's registry.
+     */
+    private resolveStoredAgents;
+    /**
+     * Resolve stored memory config to a MastraMemory instance.
+     * Uses @mastra/memory Memory class to instantiate from serialized config.
+     */
+    private resolveStoredMemory;
+    /**
+     * Resolve stored scorer configs to MastraScorers instances.
+     */
+    private resolveStoredScorers;
+    /**
+     * Look up a processor by key or ID from Mastra's registry.
+     */
+    private findProcessor;
+    /**
+     * Resolve stored input processor keys to actual processor instances.
+     */
+    private resolveStoredInputProcessors;
+    /**
+     * Resolve stored output processor keys to actual processor instances.
+     */
+    private resolveStoredOutputProcessors;
+}
+
+export { MastraEditor, evaluateRuleGroup, renderTemplate, resolveInstructionBlocks };

package/dist/index.d.ts

@@ -0,0 +1,209 @@
+import { IMastraEditor, MastraEditorConfig, Mastra, Agent, StorageResolvedAgentType } from '@mastra/core';
+export { MastraEditorConfig } from '@mastra/core';
+import { RuleGroup, AgentInstructionBlock, PromptBlocksStorage, StorageCreatePromptBlockInput, StorageResolvedPromptBlockType, StorageUpdatePromptBlockInput, StorageListPromptBlocksInput, StorageListPromptBlocksOutput, StorageListPromptBlocksResolvedOutput } from '@mastra/core/storage';
+
+/**
+ * TemplateEngine: Simple variable interpolation for prompt block content.
+ *
+ * Supports:
+ *   {{variableName}}         - Direct variable substitution
+ *   {{nested.path.value}}    - Dot-notation path resolution
+ *   {{variable || 'default'}} - Fallback values (single or double quotes)
+ *
+ * Variables that cannot be resolved (and have no fallback) are left as-is.
+ */
+/**
+ * Renders a template string by interpolating variables from the given context.
+ *
+ * @param template - The template string with {{variable}} placeholders
+ * @param context - A key-value context object for variable resolution
+ * @returns The rendered string with variables replaced
+ */
+declare function renderTemplate(template: string, context: Record<string, unknown>): string;
+
+/**
+ * RuleEvaluator: Evaluates recursive RuleGroup conditions against a context object.
+ *
+ * Supports:
+ *   - Leaf rules with operators: equals, not_equals, contains, not_contains,
+ *     greater_than, less_than, greater_than_or_equal, less_than_or_equal,
+ *     in, not_in, exists, not_exists
+ *   - Recursive AND / OR grouping via RuleGroup
+ */
+
+/**
+ * Evaluates a RuleGroup (which may contain nested RuleGroups) against a context object.
+ *
+ * @param ruleGroup - The rule group to evaluate (AND/OR with nested conditions)
+ * @param context - The context object to evaluate against
+ * @returns true if the rule group passes, false otherwise
+ */
+declare function evaluateRuleGroup(ruleGroup: RuleGroup, context: Record<string, unknown>): boolean;
+
+/**
+ * InstructionBuilder: Resolves an array of AgentInstructionBlock items
+ * into a final instruction string.
+ *
+ * For each block:
+ *  - `{ type: 'text', content }` → render template with context
+ *  - `{ type: 'prompt_block_ref', id }` → fetch from storage, evaluate rules, render template
+ *  - `{ type: 'prompt_block', content, rules? }` → inline block, evaluate rules, render template
+ *
+ * Blocks that fail rule evaluation are excluded.
+ * Resolved text segments are joined with double newlines.
+ */
+
+interface InstructionBuilderDeps {
+    promptBlocksStorage: PromptBlocksStorage;
+}
+/**
+ * Resolves an array of instruction blocks into a final instruction string.
+ *
+ * @param blocks - Array of instruction block references (text, prompt_block_ref, or inline prompt_block)
+ * @param context - Runtime context for template interpolation and rule evaluation
+ * @param deps - Dependencies (storage)
+ * @returns The resolved instruction string
+ */
+declare function resolveInstructionBlocks(blocks: AgentInstructionBlock[], context: Record<string, unknown>, deps: InstructionBuilderDeps): Promise<string>;
+
+declare class MastraEditor implements IMastraEditor {
+    private logger?;
+    private mastra?;
+    constructor(config?: MastraEditorConfig);
+    /**
+     * Register this editor with a Mastra instance.
+     * This gives the editor access to Mastra's storage, tools, workflows, etc.
+     */
+    registerWithMastra(mastra: Mastra): void;
+    /**
+     * Get the agents storage domain from the Mastra storage.
+     */
+    private getAgentsStore;
+    /**
+     * Get the prompt blocks storage domain from the Mastra storage.
+     */
+    private getPromptBlocksStore;
+    /**
+     * Get a stored agent by its ID.
+     * Returns null when agent is not found. Returns an Agent instance by default,
+     * or raw StorageResolvedAgentType when raw option is true.
+     */
+    getStoredAgentById(id: string, options?: {
+        returnRaw?: false;
+        versionId?: string;
+        versionNumber?: number;
+    }): Promise<Agent | null>;
+    getStoredAgentById(id: string, options: {
+        returnRaw: true;
+        versionId?: string;
+        versionNumber?: number;
+    }): Promise<StorageResolvedAgentType | null>;
+    /**
+     * List all stored agents with page-based pagination.
+     */
+    listStoredAgents(options?: {
+        returnRaw?: false;
+        page?: number;
+        pageSize?: number;
+    }): Promise<{
+        agents: Agent[];
+        total: number;
+        page: number;
+        perPage: number;
+        hasMore: boolean;
+    }>;
+    listStoredAgents(options: {
+        returnRaw: true;
+        page?: number;
+        pageSize?: number;
+    }): Promise<{
+        agents: StorageResolvedAgentType[];
+        total: number;
+        page: number;
+        perPage: number;
+        hasMore: boolean;
+    }>;
+    /**
+     * Create a new prompt block with an initial version.
+     */
+    createPromptBlock(input: StorageCreatePromptBlockInput): Promise<StorageResolvedPromptBlockType>;
+    /**
+     * Get a prompt block by ID, resolved with its active version.
+     */
+    getPromptBlock(id: string): Promise<StorageResolvedPromptBlockType | null>;
+    /**
+     * Update a prompt block, creating a new version with the changes.
+     */
+    updatePromptBlock(input: StorageUpdatePromptBlockInput): Promise<StorageResolvedPromptBlockType>;
+    /**
+     * Delete a prompt block and all its versions.
+     */
+    deletePromptBlock(id: string): Promise<void>;
+    /**
+     * List prompt blocks with optional pagination and filtering.
+     */
+    listPromptBlocks(args?: StorageListPromptBlocksInput): Promise<StorageListPromptBlocksOutput>;
+    /**
+     * List prompt blocks resolved with their active version config.
+     */
+    listPromptBlocksResolved(args?: StorageListPromptBlocksInput): Promise<StorageListPromptBlocksResolvedOutput>;
+    /**
+     * Preview the resolved instructions for a given set of instruction blocks and context.
+     * Useful for UI preview endpoints.
+     */
+    previewInstructions(blocks: AgentInstructionBlock[], context: Record<string, unknown>): Promise<string>;
+    /**
+     * Clear the stored agent cache for a specific agent ID, or all cached agents.
+     * When clearing a specific agent, also removes it from Mastra's agent registry
+     * so that fresh data is loaded on next access.
+     */
+    clearStoredAgentCache(agentId?: string): void;
+    /**
+     * Create an Agent instance from stored configuration.
+     * Resolves all stored references (tools, workflows, agents, memory, scorers)
+     * and registers the agent with the Mastra instance.
+     */
+    private createAgentFromStoredConfig;
+    /**
+     * Resolve stored instructions to a value compatible with the Agent constructor.
+     * - `string` → pass through as-is (backward compatible)
+     * - `AgentInstructionBlock[]` → wrap in a DynamicArgument function that resolves at runtime
+     * - `undefined` → return undefined
+     */
+    private resolveStoredInstructions;
+    /**
+     * Resolve stored tool IDs to actual tool instances from Mastra's registry.
+     */
+    private resolveStoredTools;
+    /**
+     * Resolve stored workflow IDs to actual workflow instances from Mastra's registry.
+     */
+    private resolveStoredWorkflows;
+    /**
+     * Resolve stored agent IDs to actual agent instances from Mastra's registry.
+     */
+    private resolveStoredAgents;
+    /**
+     * Resolve stored memory config to a MastraMemory instance.
+     * Uses @mastra/memory Memory class to instantiate from serialized config.
+     */
+    private resolveStoredMemory;
+    /**
+     * Resolve stored scorer configs to MastraScorers instances.
+     */
+    private resolveStoredScorers;
+    /**
+     * Look up a processor by key or ID from Mastra's registry.
+     */
+    private findProcessor;
+    /**
+     * Resolve stored input processor keys to actual processor instances.
+     */
+    private resolveStoredInputProcessors;
+    /**
+     * Resolve stored output processor keys to actual processor instances.
+     */
+    private resolveStoredOutputProcessors;
+}
+
+export { MastraEditor, evaluateRuleGroup, renderTemplate, resolveInstructionBlocks };