@olane/o-lane 0.7.12-alpha.9 → 0.7.13-alpha.0

package/dist/src/storage/methods/prompt-storage.methods.js

@@ -0,0 +1,338 @@
+/**
+ * Method definitions for prompt-specific storage operations
+ * Extends standard storage with promptId namespace isolation
+ */
+export const PROMPT_STORAGE_METHODS = {
+    put: {
+        name: 'put',
+        description: 'Store data in a prompt-specific namespace. Data is isolated per promptId.',
+        dependencies: [],
+        parameters: [
+            {
+                name: 'promptId',
+                type: 'string',
+                value: 'string',
+                description: 'Unique prompt/conversation identifier for namespace isolation',
+                required: true,
+            },
+            {
+                name: 'key',
+                type: 'string',
+                value: 'string',
+                description: 'Key to store the data under within the prompt namespace',
+                required: true,
+            },
+            {
+                name: 'value',
+                type: 'string',
+                value: 'string',
+                description: 'The data to store',
+                required: true,
+            },
+        ],
+        examples: [
+            {
+                description: 'Store user preference in a conversation',
+                intent: 'Store the user name Alice for conversation 123',
+                params: {
+                    promptId: 'conversation-123',
+                    key: 'user_name',
+                    value: 'Alice',
+                },
+                expectedResult: {
+                    success: true,
+                },
+            },
+        ],
+        performance: {
+            estimatedDuration: 10,
+            maxDuration: 1000,
+            idempotent: true,
+            cacheable: false,
+        },
+        approvalMetadata: {
+            riskLevel: 'low',
+            category: 'write',
+            description: 'Store data in isolated prompt namespace',
+        },
+    },
+    get: {
+        name: 'get',
+        description: 'Retrieve data from a prompt-specific namespace. Returns null if key not found.',
+        dependencies: [],
+        parameters: [
+            {
+                name: 'promptId',
+                type: 'string',
+                value: 'string',
+                description: 'Unique prompt/conversation identifier',
+                required: true,
+            },
+            {
+                name: 'key',
+                type: 'string',
+                value: 'string',
+                description: 'The key to retrieve from the prompt namespace',
+                required: true,
+            },
+        ],
+        examples: [
+            {
+                description: 'Retrieve stored user preference',
+                intent: 'Get the user name from conversation 123',
+                params: {
+                    promptId: 'conversation-123',
+                    key: 'user_name',
+                },
+                expectedResult: {
+                    value: 'Alice',
+                },
+            },
+        ],
+        performance: {
+            estimatedDuration: 5,
+            maxDuration: 500,
+            idempotent: true,
+            cacheable: true,
+        },
+        approvalMetadata: {
+            riskLevel: 'low',
+            category: 'read',
+            description: 'Read data from isolated prompt namespace',
+        },
+    },
+    delete: {
+        name: 'delete',
+        description: 'Delete a specific key from a prompt namespace.',
+        dependencies: [],
+        parameters: [
+            {
+                name: 'promptId',
+                type: 'string',
+                value: 'string',
+                description: 'Unique prompt/conversation identifier',
+                required: true,
+            },
+            {
+                name: 'key',
+                type: 'string',
+                value: 'string',
+                description: 'The key to delete from the prompt namespace',
+                required: true,
+            },
+        ],
+        examples: [
+            {
+                description: 'Delete a stored value',
+                intent: 'Delete the user name from conversation 123',
+                params: {
+                    promptId: 'conversation-123',
+                    key: 'user_name',
+                },
+                expectedResult: {
+                    success: true,
+                },
+            },
+        ],
+        performance: {
+            estimatedDuration: 10,
+            maxDuration: 1000,
+            idempotent: true,
+            cacheable: false,
+        },
+        approvalMetadata: {
+            riskLevel: 'low',
+            category: 'write',
+            description: 'Delete data from isolated prompt namespace',
+        },
+    },
+    has: {
+        name: 'has',
+        description: 'Check if a key exists in a prompt namespace.',
+        dependencies: [],
+        parameters: [
+            {
+                name: 'promptId',
+                type: 'string',
+                value: 'string',
+                description: 'Unique prompt/conversation identifier',
+                required: true,
+            },
+            {
+                name: 'key',
+                type: 'string',
+                value: 'string',
+                description: 'The key to check in the prompt namespace',
+                required: true,
+            },
+        ],
+        examples: [
+            {
+                description: 'Check if a key exists',
+                intent: 'Check if user name exists in conversation 123',
+                params: {
+                    promptId: 'conversation-123',
+                    key: 'user_name',
+                },
+                expectedResult: {
+                    success: true,
+                },
+            },
+        ],
+        performance: {
+            estimatedDuration: 5,
+            maxDuration: 500,
+            idempotent: true,
+            cacheable: true,
+        },
+        approvalMetadata: {
+            riskLevel: 'low',
+            category: 'read',
+            description: 'Check key existence in isolated prompt namespace',
+        },
+    },
+    list_prompts: {
+        name: 'list_prompts',
+        description: 'List all prompt IDs that have active storage. Returns an array of prompt identifiers.',
+        dependencies: [],
+        parameters: [],
+        examples: [
+            {
+                description: 'List all prompts with storage',
+                intent: 'Show all conversations that have stored data',
+                params: {},
+                expectedResult: {
+                    promptIds: ['conversation-123', 'conversation-456'],
+                    count: 2,
+                },
+            },
+        ],
+        performance: {
+            estimatedDuration: 10,
+            maxDuration: 1000,
+            idempotent: true,
+            cacheable: true,
+        },
+        approvalMetadata: {
+            riskLevel: 'low',
+            category: 'read',
+            description: 'List all prompt namespaces',
+        },
+    },
+    clear_prompt: {
+        name: 'clear_prompt',
+        description: 'Clear all data for a specific prompt namespace. This removes all keys and values.',
+        dependencies: [],
+        parameters: [
+            {
+                name: 'promptId',
+                type: 'string',
+                value: 'string',
+                description: 'Unique prompt/conversation identifier to clear',
+                required: true,
+            },
+        ],
+        examples: [
+            {
+                description: 'Clear all data for a conversation',
+                intent: 'Delete all stored data for conversation 123',
+                params: {
+                    promptId: 'conversation-123',
+                },
+                expectedResult: {
+                    success: true,
+                    keysDeleted: 5,
+                },
+            },
+        ],
+        performance: {
+            estimatedDuration: 20,
+            maxDuration: 2000,
+            idempotent: true,
+            cacheable: false,
+        },
+        approvalMetadata: {
+            riskLevel: 'medium',
+            category: 'write',
+            description: 'Clear entire prompt namespace',
+        },
+    },
+    get_prompt_keys: {
+        name: 'get_prompt_keys',
+        description: 'Get all keys stored in a specific prompt namespace. Returns an array of key names.',
+        dependencies: [],
+        parameters: [
+            {
+                name: 'promptId',
+                type: 'string',
+                value: 'string',
+                description: 'Unique prompt/conversation identifier',
+                required: true,
+            },
+        ],
+        examples: [
+            {
+                description: 'Get all keys for a conversation',
+                intent: 'List all data keys stored for conversation 123',
+                params: {
+                    promptId: 'conversation-123',
+                },
+                expectedResult: {
+                    keys: ['user_name', 'user_email', 'preferences'],
+                    count: 3,
+                },
+            },
+        ],
+        performance: {
+            estimatedDuration: 10,
+            maxDuration: 1000,
+            idempotent: true,
+            cacheable: true,
+        },
+        approvalMetadata: {
+            riskLevel: 'low',
+            category: 'read',
+            description: 'List keys in prompt namespace',
+        },
+    },
+    get_prompt_stats: {
+        name: 'get_prompt_stats',
+        description: 'Get statistics for a specific prompt namespace including key count and last accessed time.',
+        dependencies: [],
+        parameters: [
+            {
+                name: 'promptId',
+                type: 'string',
+                value: 'string',
+                description: 'Unique prompt/conversation identifier',
+                required: true,
+            },
+        ],
+        examples: [
+            {
+                description: 'Get stats for a conversation',
+                intent: 'Show storage statistics for conversation 123',
+                params: {
+                    promptId: 'conversation-123',
+                },
+                expectedResult: {
+                    promptId: 'conversation-123',
+                    keyCount: 3,
+                    lastAccessed: 1638360000000,
+                    exists: true,
+                },
+            },
+        ],
+        performance: {
+            estimatedDuration: 10,
+            maxDuration: 1000,
+            idempotent: true,
+            cacheable: true,
+        },
+        approvalMetadata: {
+            riskLevel: 'low',
+            category: 'read',
+            description: 'Get prompt namespace statistics',
+        },
+    },
+};

package/dist/src/storage/prompt-loader.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Prompt Loader
+ *
+ * Loads and compiles prompts from PromptStorageProvider with fallback to hardcoded versions
+ */
+import { PromptStorageProvider } from './prompt-storage-provider.tool.js';
+/**
+ * Loads prompts from storage and compiles them into final prompt strings
+ */
+export declare class PromptLoader {
+    private storage?;
+    private cache;
+    private useStorage;
+    constructor(storage?: PromptStorageProvider | undefined);
+    /**
+     * Generate agent prompt (equivalent to AGENT_PROMPT function)
+     */
+    generateAgentPrompt(intent: string, context: string, agentHistory: string, extraInstructions: string): Promise<string>;
+    /**
+     * Generate custom agent prompt (equivalent to CUSTOM_AGENT_PROMPT function)
+     */
+    generateCustomAgentPrompt(intent: string, context: string, agentHistory: string, cycleInstructions: string, outputInstructions: string, extraInstructions: string): Promise<string>;
+    /**
+     * Load configure instructions
+     */
+    loadConfigureInstructions(): Promise<string>;
+    /**
+     * Load a template from storage
+     */
+    private loadTemplate;
+    /**
+     * Clear the template cache
+     */
+    clearCache(): void;
+    /**
+     * Enable or disable storage usage
+     */
+    setUseStorage(use: boolean): void;
+}
+//# sourceMappingURL=prompt-loader.d.ts.map

package/dist/src/storage/prompt-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-loader.d.ts","sourceRoot":"","sources":["../../../src/storage/prompt-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAU1E;;GAEG;AACH,qBAAa,YAAY;IAIX,OAAO,CAAC,OAAO,CAAC;IAH5B,OAAO,CAAC,KAAK,CAAgD;IAC7D,OAAO,CAAC,UAAU,CAAiB;gBAEf,OAAO,CAAC,mCAAuB;IAMnD;;OAEG;IACG,mBAAmB,CACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,MAAM,CAAC;IAiClB;;OAEG;IACG,yBAAyB,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,iBAAiB,EAAE,MAAM,EACzB,kBAAkB,EAAE,MAAM,EAC1B,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,MAAM,CAAC;IA0ClB;;OAEG;IACG,yBAAyB,IAAI,OAAO,CAAC,MAAM,CAAC;IAqBlD;;OAEG;YACW,YAAY;IAgC1B;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;CAGlC"}

package/dist/src/storage/prompt-loader.js

@@ -0,0 +1,126 @@
+/**
+ * Prompt Loader
+ *
+ * Loads and compiles prompts from PromptStorageProvider with fallback to hardcoded versions
+ */
+import { PROMPT_KEYS, PROMPT_IDS, } from './prompt-schema.js';
+import { AGENT_PROMPT } from '../prompts/agent.prompt.js';
+import { CUSTOM_AGENT_PROMPT } from '../prompts/custom.prompt.js';
+import { CONFIGURE_INSTRUCTIONS } from '../prompts/configure.prompt.js';
+/**
+ * Loads prompts from storage and compiles them into final prompt strings
+ */
+export class PromptLoader {
+    constructor(storage) {
+        this.storage = storage;
+        this.cache = new Map();
+        this.useStorage = true;
+        if (!storage) {
+            this.useStorage = false;
+        }
+    }
+    /**
+     * Generate agent prompt (equivalent to AGENT_PROMPT function)
+     */
+    async generateAgentPrompt(intent, context, agentHistory, extraInstructions) {
+        if (!this.useStorage || !this.storage) {
+            // Fallback to hardcoded version
+            return AGENT_PROMPT(intent, context, agentHistory, extraInstructions);
+        }
+        try {
+            // Load templates from storage
+            const cycleInstructions = await this.loadTemplate(PROMPT_IDS.AGENT, PROMPT_KEYS.CYCLE_INSTRUCTIONS);
+            const outputInstructions = await this.loadTemplate(PROMPT_IDS.AGENT, PROMPT_KEYS.OUTPUT_INSTRUCTIONS);
+            // Compile using custom agent prompt
+            return await this.generateCustomAgentPrompt(intent, context, agentHistory, cycleInstructions, outputInstructions, extraInstructions);
+        }
+        catch (error) {
+            // Fallback to hardcoded version on error
+            console.warn('Failed to load prompts from storage, using fallback', error);
+            return AGENT_PROMPT(intent, context, agentHistory, extraInstructions);
+        }
+    }
+    /**
+     * Generate custom agent prompt (equivalent to CUSTOM_AGENT_PROMPT function)
+     */
+    async generateCustomAgentPrompt(intent, context, agentHistory, cycleInstructions, outputInstructions, extraInstructions) {
+        if (!this.useStorage || !this.storage) {
+            // Fallback to hardcoded version
+            return CUSTOM_AGENT_PROMPT(intent, context, agentHistory, cycleInstructions, outputInstructions, extraInstructions);
+        }
+        try {
+            // Load base template from storage
+            const baseTemplate = await this.loadTemplate(PROMPT_IDS.AGENT, PROMPT_KEYS.BASE_TEMPLATE);
+            // Replace placeholders with actual values
+            return baseTemplate
+                .replace('{{intent}}', intent)
+                .replace('{{context}}', context)
+                .replace('{{agentHistory}}', agentHistory)
+                .replace('{{cycleInstructions}}', cycleInstructions)
+                .replace('{{outputInstructions}}', outputInstructions)
+                .replace('{{extraInstructions}}', extraInstructions);
+        }
+        catch (error) {
+            // Fallback to hardcoded version on error
+            console.warn('Failed to load base template from storage, using fallback', error);
+            return CUSTOM_AGENT_PROMPT(intent, context, agentHistory, cycleInstructions, outputInstructions, extraInstructions);
+        }
+    }
+    /**
+     * Load configure instructions
+     */
+    async loadConfigureInstructions() {
+        if (!this.useStorage || !this.storage) {
+            // Fallback to hardcoded version
+            return CONFIGURE_INSTRUCTIONS;
+        }
+        try {
+            return await this.loadTemplate(PROMPT_IDS.AGENT, PROMPT_KEYS.CONFIGURE_INSTRUCTIONS);
+        }
+        catch (error) {
+            // Fallback to hardcoded version on error
+            console.warn('Failed to load configure instructions from storage, using fallback', error);
+            return CONFIGURE_INSTRUCTIONS;
+        }
+    }
+    /**
+     * Load a template from storage
+     */
+    async loadTemplate(promptId, key) {
+        // Check cache first
+        const cacheKey = `${promptId}:${key}`;
+        if (this.cache.has(cacheKey)) {
+            return this.cache.get(cacheKey).content;
+        }
+        if (!this.storage) {
+            throw new Error('Storage not available');
+        }
+        // Load from storage
+        const response = await this.storage.use(this.storage.address, {
+            method: 'get',
+            params: { promptId, key },
+        });
+        if (!response.result.success) {
+            throw new Error(`Failed to load template: ${response.result.error}`);
+        }
+        const template = response.result?.data?.value;
+        if (!template || !template.content) {
+            throw new Error(`Template not found: ${promptId}/${key}`);
+        }
+        // Cache for future use
+        this.cache.set(cacheKey, template);
+        return template.content;
+    }
+    /**
+     * Clear the template cache
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Enable or disable storage usage
+     */
+    setUseStorage(use) {
+        this.useStorage = use && !!this.storage;
+    }
+}

package/dist/src/storage/prompt-schema.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Prompt Storage Schema
+ *
+ * Defines the structure for storing prompt templates in PromptStorageProvider
+ */
+/**
+ * Prompt storage keys for the 'agent' promptId namespace
+ */
+export declare const PROMPT_KEYS: {
+    readonly BASE_TEMPLATE: "base_template";
+    readonly CYCLE_INSTRUCTIONS: "cycle_instructions";
+    readonly OUTPUT_INSTRUCTIONS: "output_instructions";
+    readonly CONFIGURE_INSTRUCTIONS: "configure_instructions";
+};
+/**
+ * Prompt namespace IDs
+ */
+export declare const PROMPT_IDS: {
+    readonly AGENT: "agent";
+    readonly CUSTOM: "custom";
+};
+/**
+ * Version tracking for prompt templates
+ */
+export declare const PROMPT_VERSION = "1.0.0";
+/**
+ * Interface for prompt template metadata
+ */
+export interface PromptTemplateMetadata {
+    version: string;
+    description: string;
+    lastModified: number;
+    source: string;
+}
+/**
+ * Type for stored prompt data
+ */
+export interface StoredPromptTemplate {
+    content: string;
+    metadata: PromptTemplateMetadata;
+}
+//# sourceMappingURL=prompt-schema.d.ts.map

package/dist/src/storage/prompt-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-schema.d.ts","sourceRoot":"","sources":["../../../src/storage/prompt-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;CAYd,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;;;CAGb,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,sBAAsB,CAAC;CAClC"}

package/dist/src/storage/prompt-schema.js

@@ -0,0 +1,29 @@
+/**
+ * Prompt Storage Schema
+ *
+ * Defines the structure for storing prompt templates in PromptStorageProvider
+ */
+/**
+ * Prompt storage keys for the 'agent' promptId namespace
+ */
+export const PROMPT_KEYS = {
+    // Base template structure (from custom.prompt.ts)
+    BASE_TEMPLATE: 'base_template',
+    // Cycle instructions for agent workflow (from agent.prompt.ts lines 13-68)
+    CYCLE_INSTRUCTIONS: 'cycle_instructions',
+    // Output/return format instructions (from agent.prompt.ts lines 70-145)
+    OUTPUT_INSTRUCTIONS: 'output_instructions',
+    // Configure-specific instructions (from configure.prompt.ts)
+    CONFIGURE_INSTRUCTIONS: 'configure_instructions',
+};
+/**
+ * Prompt namespace IDs
+ */
+export const PROMPT_IDS = {
+    AGENT: 'agent',
+    CUSTOM: 'custom',
+};
+/**
+ * Version tracking for prompt templates
+ */
+export const PROMPT_VERSION = '1.0.0';

package/dist/src/storage/prompt-seeder.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Prompt Seeder
+ *
+ * Seeds the PromptStorageProvider with prompt templates from prompts/ folder
+ */
+import { PromptStorageProvider } from './prompt-storage-provider.tool.js';
+/**
+ * Seeds the prompt storage with default prompt templates
+ */
+export declare class PromptSeeder {
+    private storage;
+    constructor(storage: PromptStorageProvider);
+    /**
+     * Seed all default prompts into storage
+     */
+    seedAll(): Promise<void>;
+    /**
+     * Seed the base template from custom.prompt.ts
+     */
+    private seedBaseTemplate;
+    /**
+     * Seed cycle instructions from agent.prompt.ts
+     */
+    private seedCycleInstructions;
+    /**
+     * Seed output instructions from agent.prompt.ts
+     */
+    private seedOutputInstructions;
+    /**
+     * Seed configure instructions from configure.prompt.ts
+     */
+    private seedConfigureInstructions;
+    /**
+     * Check if prompts are already seeded
+     */
+    isSeeded(): Promise<boolean>;
+    /**
+     * Clear all seeded prompts
+     */
+    clearAll(): Promise<void>;
+}
+//# sourceMappingURL=prompt-seeder.d.ts.map

package/dist/src/storage/prompt-seeder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-seeder.d.ts","sourceRoot":"","sources":["../../../src/storage/prompt-seeder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAc1E;;GAEG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,qBAAqB;IAElD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B;;OAEG;YACW,gBAAgB;IAqB9B;;OAEG;YACW,qBAAqB;IAqBnC;;OAEG;YACW,sBAAsB;IAqBpC;;OAEG;YACW,yBAAyB;IAqBvC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBlC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAQhC"}