@troykelly/openclaw-projects 0.0.1

package/dist/hooks.js

@@ -0,0 +1,314 @@
+/**
+ * Plugin lifecycle hooks implementation.
+ * Provides auto-recall and auto-capture functionality.
+ */
+/** Default timeout for auto-recall hook (5 seconds) */
+const DEFAULT_RECALL_TIMEOUT_MS = 5000;
+/** Default timeout for auto-capture hook (10 seconds) */
+const DEFAULT_CAPTURE_TIMEOUT_MS = 10000;
+/** Patterns that indicate sensitive content to filter */
+const SENSITIVE_PATTERNS = [
+    /\b(?:password|passwd|pwd)\s*[:=]\s*\S+/gi,
+    /\b(?:api[_-]?key|apikey)\s*[:=]\s*\S+/gi,
+    /\bsk-[a-zA-Z0-9]{10,}/g, // API keys (10+ chars after sk-)
+    /\b(?:secret|token)\s*[:=]\s*\S+/gi,
+    /\b\d{4}[\s-]?\d{4}[\s-]?\d{4}[\s-]?\d{4}\b/, // Credit card numbers
+    /\b\d{3}-\d{2}-\d{4}\b/, // SSN
+];
+/**
+ * Create a promise that rejects after a timeout.
+ */
+function createTimeoutPromise(ms, timeoutResult) {
+    return new Promise((resolve) => {
+        setTimeout(() => resolve(timeoutResult), ms);
+    });
+}
+/**
+ * Check if content contains sensitive patterns.
+ */
+function containsSensitiveContent(content) {
+    return SENSITIVE_PATTERNS.some((pattern) => pattern.test(content));
+}
+/**
+ * Filter sensitive content from a string.
+ */
+function filterSensitiveContent(content) {
+    let filtered = content;
+    for (const pattern of SENSITIVE_PATTERNS) {
+        filtered = filtered.replace(pattern, '[REDACTED]');
+    }
+    return filtered;
+}
+/**
+ * Creates the auto-recall hook (before_agent_start).
+ *
+ * This hook fetches relevant context from the backend based on the user's prompt
+ * and returns it to be prepended to the conversation.
+ */
+export function createAutoRecallHook(options) {
+    const { client, logger, config, userId, timeoutMs = DEFAULT_RECALL_TIMEOUT_MS, } = options;
+    return async (event) => {
+        // Skip if auto-recall is disabled
+        if (!config.autoRecall) {
+            logger.debug('auto-recall skipped: disabled in config', { userId });
+            return null;
+        }
+        // Log without prompt content
+        logger.info('auto-recall invoked', {
+            userId,
+            promptLength: event.prompt.length,
+        });
+        try {
+            // Race between API call and timeout
+            const result = await Promise.race([
+                fetchContext(client, userId, event.prompt, logger, config.maxRecallMemories),
+                createTimeoutPromise(timeoutMs, null).then(() => {
+                    logger.warn('auto-recall timeout exceeded', { userId, timeoutMs });
+                    return null;
+                }),
+            ]);
+            if (result === null) {
+                logger.debug('auto-recall returned no context', { userId });
+                return null;
+            }
+            logger.debug('auto-recall completed', {
+                userId,
+                contextLength: result.prependContext.length,
+            });
+            return result;
+        }
+        catch (error) {
+            logger.error('auto-recall failed', {
+                userId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return null;
+        }
+    };
+}
+/**
+ * Fetch context from the backend API using semantic memory search.
+ *
+ * Uses the existing `/api/memories/search` endpoint (which works)
+ * instead of the non-existent `/api/context` endpoint.
+ * The user's actual prompt is passed as the search query for semantic matching.
+ */
+async function fetchContext(client, userId, prompt, logger, maxResults = 5) {
+    // Truncate prompt to a reasonable length for the search query
+    const searchQuery = prompt.substring(0, 500);
+    const queryParams = new URLSearchParams({
+        q: searchQuery,
+        limit: String(maxResults),
+    });
+    const response = await client.get(`/api/memories/search?${queryParams.toString()}`, { userId });
+    if (!response.success) {
+        logger.error('auto-recall API error', {
+            userId,
+            status: response.error.status,
+            code: response.error.code,
+        });
+        return null;
+    }
+    const memories = response.data.memories ?? [];
+    if (memories.length === 0) {
+        return null;
+    }
+    // Format memories as context to prepend to the conversation
+    const context = memories
+        .map((m) => `- [${m.category}] ${m.content}`)
+        .join('\n');
+    return {
+        prependContext: context,
+    };
+}
+/**
+ * Creates the auto-capture hook (agent_end).
+ *
+ * This hook analyzes the completed conversation and stores important
+ * information as memories.
+ */
+export function createAutoCaptureHook(options) {
+    const { client, logger, config, userId, timeoutMs = DEFAULT_CAPTURE_TIMEOUT_MS, } = options;
+    return async (event) => {
+        // Skip if auto-capture is disabled
+        if (!config.autoCapture) {
+            logger.debug('auto-capture skipped: disabled in config', { userId });
+            return;
+        }
+        // Skip empty conversations
+        if (!event.messages || event.messages.length === 0) {
+            logger.debug('auto-capture skipped: no messages', { userId });
+            return;
+        }
+        // Log without message content
+        logger.info('auto-capture invoked', {
+            userId,
+            messageCount: event.messages.length,
+        });
+        try {
+            // Race between API call and timeout
+            await Promise.race([
+                captureContext(client, userId, event.messages, logger),
+                createTimeoutPromise(timeoutMs, undefined).then(() => {
+                    logger.warn('auto-capture timeout exceeded', { userId, timeoutMs });
+                }),
+            ]);
+            logger.debug('auto-capture completed', { userId });
+        }
+        catch (error) {
+            logger.error('auto-capture failed', {
+                userId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            // Don't throw - hook errors should not crash the agent
+        }
+    };
+}
+/**
+ * Capture context from conversation messages.
+ */
+async function captureContext(client, userId, messages, logger) {
+    // Filter out messages with sensitive content
+    const filteredMessages = messages.filter((msg) => {
+        if (containsSensitiveContent(msg.content)) {
+            logger.debug('auto-capture filtered sensitive message', { userId });
+            return false;
+        }
+        return true;
+    });
+    if (filteredMessages.length === 0) {
+        logger.debug('auto-capture skipped: all messages filtered', { userId });
+        return;
+    }
+    // Prepare conversation summary for capture
+    const conversationSummary = filteredMessages
+        .map((msg) => filterSensitiveContent(msg.content))
+        .join('\n');
+    const response = await client.post('/api/context/capture', {
+        conversation: conversationSummary,
+        messageCount: filteredMessages.length,
+    }, { userId });
+    if (!response.success) {
+        logger.error('auto-capture API error', {
+            userId,
+            status: response.error.status,
+            code: response.error.code,
+        });
+    }
+}
+/**
+ * Creates a graph-aware auto-recall hook (before_agent_start).
+ *
+ * This hook uses the graph-aware context retrieval API to fetch memories
+ * across the user's relationship graph (personal, contact, group, relationship
+ * scopes). Falls back to basic memory search if the graph-aware endpoint
+ * is unavailable.
+ *
+ * Part of Epic #486, Issue #497.
+ */
+export function createGraphAwareRecallHook(options) {
+    const { client, logger, config, userId, timeoutMs = DEFAULT_RECALL_TIMEOUT_MS, } = options;
+    return async (event) => {
+        // Skip if auto-recall is disabled
+        if (!config.autoRecall) {
+            logger.debug('graph-aware-recall skipped: disabled in config', { userId });
+            return null;
+        }
+        // Log without prompt content
+        logger.info('graph-aware-recall invoked', {
+            userId,
+            promptLength: event.prompt.length,
+        });
+        try {
+            // Race between API call and timeout
+            const result = await Promise.race([
+                fetchGraphAwareContext(client, userId, event.prompt, logger, config.maxRecallMemories),
+                createTimeoutPromise(timeoutMs, null).then(() => {
+                    logger.warn('graph-aware-recall timeout exceeded', { userId, timeoutMs });
+                    return null;
+                }),
+            ]);
+            if (result === null) {
+                logger.debug('graph-aware-recall returned no context', { userId });
+                return null;
+            }
+            logger.debug('graph-aware-recall completed', {
+                userId,
+                contextLength: result.prependContext.length,
+            });
+            return result;
+        }
+        catch (error) {
+            logger.error('graph-aware-recall failed', {
+                userId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return null;
+        }
+    };
+}
+/**
+ * Fetch context using the graph-aware context retrieval API.
+ *
+ * Calls POST /api/context/graph-aware with the user's prompt for
+ * multi-scope semantic search across relationships.
+ * Falls back to basic /api/memories/search if the graph-aware endpoint fails.
+ */
+async function fetchGraphAwareContext(client, userId, prompt, logger, maxResults = 10) {
+    // Truncate prompt for the search query
+    const searchPrompt = prompt.substring(0, 500);
+    // Try graph-aware endpoint first
+    const graphResponse = await client.post('/api/context/graph-aware', {
+        prompt: searchPrompt,
+        maxMemories: maxResults,
+        maxDepth: 1,
+    }, { userId });
+    if (graphResponse.success && graphResponse.data.context) {
+        logger.debug('graph-aware context retrieved', {
+            userId,
+            memoryCount: graphResponse.data.memories.length,
+            scopeCount: graphResponse.data.metadata.scopeCount,
+            searchType: graphResponse.data.metadata.searchType,
+            queryTimeMs: graphResponse.data.metadata.queryTimeMs,
+        });
+        return {
+            prependContext: graphResponse.data.context,
+        };
+    }
+    // Fall back to basic memory search if graph-aware endpoint fails
+    logger.debug('graph-aware endpoint unavailable, falling back to basic recall', {
+        userId,
+        graphError: graphResponse.success ? 'no context' : graphResponse.error.code,
+    });
+    return fetchContext(client, userId, prompt, logger, maxResults);
+}
+/**
+ * Creates the health check function.
+ */
+export function createHealthCheck(options) {
+    const { client, logger } = options;
+    return async () => {
+        try {
+            const response = await client.healthCheck();
+            if (!response.healthy) {
+                logger.warn('health check failed', { latencyMs: response.latencyMs });
+                return {
+                    healthy: false,
+                    error: 'Health check failed',
+                };
+            }
+            logger.debug('health check passed', { latencyMs: response.latencyMs });
+            return { healthy: true };
+        }
+        catch (error) {
+            logger.error('health check error', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return {
+                healthy: false,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,106 @@
+/**
+ * OpenClaw Projects Plugin
+ *
+ * This plugin provides memory management, projects, todos, and contacts
+ * integration for OpenClaw agents.
+ *
+ * Supports two registration patterns:
+ * 1. OpenClaw 2026 API: `export default (api) => { ... }` (recommended)
+ * 2. Legacy API: `register(ctx)` returns plugin instance (deprecated)
+ */
+export { default, registerOpenClaw, schemas } from './register-openclaw.js';
+export type { OpenClawPluginAPI, PluginInitializer, PluginDefinition, ToolDefinition, ToolContext, ToolResult, JSONSchema, JSONSchemaProperty, HookEvent, HookHandler, PluginHookName, PluginHookBeforeAgentStartEvent, PluginHookAgentContext, PluginHookBeforeAgentStartResult, PluginHookAgentEndEvent, CliRegistrationCallback, CliRegistrationContext, ServiceDefinition, } from './types/openclaw-api.js';
+import type { PluginConfig } from './config.js';
+import { type Logger } from './logger.js';
+import { type ApiClient } from './api-client.js';
+import { type PluginContext } from './context.js';
+import { type AutoRecallEvent, type AutoRecallResult, type AutoCaptureEvent, type HealthCheckResult } from './hooks.js';
+import { type CliCommands } from './cli.js';
+import { type MemoryRecallTool, type MemoryStoreTool, type MemoryForgetTool, type ProjectListTool, type ProjectGetTool, type ProjectCreateTool, type TodoListTool, type TodoCreateTool, type TodoCompleteTool, type ContactSearchTool, type ContactGetTool, type ContactCreateTool } from './tools/index.js';
+/** Plugin registration context from OpenClaw runtime */
+export interface RegistrationContext {
+    config: Record<string, unknown>;
+    logger?: Logger;
+    runtime?: unknown;
+}
+/** Tool instances created for the plugin */
+export interface PluginTools {
+    memoryRecall: MemoryRecallTool;
+    memoryStore: MemoryStoreTool;
+    memoryForget: MemoryForgetTool;
+    projectList: ProjectListTool;
+    projectGet: ProjectGetTool;
+    projectCreate: ProjectCreateTool;
+    todoList: TodoListTool;
+    todoCreate: TodoCreateTool;
+    todoComplete: TodoCompleteTool;
+    contactSearch: ContactSearchTool;
+    contactGet: ContactGetTool;
+    contactCreate: ContactCreateTool;
+}
+/** Lifecycle hooks for the plugin */
+export interface PluginHooks {
+    beforeAgentStart: (event: AutoRecallEvent) => Promise<AutoRecallResult | null>;
+    agentEnd: (event: AutoCaptureEvent) => Promise<void>;
+}
+/** Plugin instance after registration */
+export interface PluginInstance {
+    id: string;
+    name: string;
+    kind: string;
+    config: PluginConfig;
+    apiClient: ApiClient;
+    context: PluginContext;
+    tools: PluginTools;
+    hooks: PluginHooks;
+    cli: CliCommands;
+    healthCheck: () => Promise<HealthCheckResult>;
+}
+/**
+ * Registers the plugin with OpenClaw (synchronous version).
+ *
+ * This function supports configurations with direct secret values only.
+ * For file or command-based secrets, use registerAsync instead.
+ *
+ * @deprecated Use registerAsync for flexible secret handling
+ */
+export declare function register(ctx: RegistrationContext): PluginInstance;
+/**
+ * Registers the plugin with OpenClaw (asynchronous version).
+ *
+ * This function supports all secret loading methods:
+ * - Direct values (apiKey: "sk-xxx")
+ * - File references (apiKeyFile: "~/.secrets/api_key")
+ * - Command references (apiKeyCommand: "op read op://...")
+ *
+ * Preferred over register() for flexible secret handling.
+ */
+export declare function registerAsync(ctx: RegistrationContext): Promise<PluginInstance>;
+/** Plugin definition object for OpenClaw */
+export declare const plugin: {
+    id: string;
+    name: string;
+    kind: string;
+    register: typeof register;
+};
+export type { PluginConfig, RawPluginConfig } from './config.js';
+export { validateConfig, safeValidateConfig, validateRawConfig, safeValidateRawConfig, resolveConfigSecrets, redactConfig, } from './config.js';
+export type { SecretConfig } from './secrets.js';
+export { resolveSecret, resolveSecrets, clearSecretCache, clearCachedSecret } from './secrets.js';
+export type { Logger } from './logger.js';
+export { createLogger, redactSensitive } from './logger.js';
+export type { ApiClient, ApiResponse, ApiError } from './api-client.js';
+export { createApiClient } from './api-client.js';
+export type { PluginContext, UserContext, AgentContext, SessionContext, } from './context.js';
+export { extractContext, getUserScopeKey } from './context.js';
+export type { MemoryRecallTool, MemoryRecallParams, MemoryRecallResult, Memory, MemoryStoreTool, MemoryStoreParams, MemoryStoreResult, StoredMemory, MemoryForgetTool, MemoryForgetParams, MemoryForgetResult, ProjectListTool, ProjectGetTool, ProjectCreateTool, ProjectListParams, ProjectGetParams, ProjectCreateParams, ProjectListResult, ProjectGetResult, ProjectCreateResult, Project, ProjectToolOptions, TodoListTool, TodoCreateTool, TodoCompleteTool, TodoListParams, TodoCreateParams, TodoCompleteParams, TodoListResult, TodoCreateResult, TodoCompleteResult, Todo, TodoToolOptions, ContactSearchTool, ContactGetTool, ContactCreateTool, ContactSearchParams, ContactGetParams, ContactCreateParams, ContactSearchResult, ContactGetResult, ContactCreateResult, Contact, ContactToolOptions, } from './tools/index.js';
+export { createMemoryRecallTool, createMemoryStoreTool, createMemoryForgetTool, createProjectListTool, createProjectGetTool, createProjectCreateTool, createTodoListTool, createTodoCreateTool, createTodoCompleteTool, createContactSearchTool, createContactGetTool, createContactCreateTool, MemoryRecallParamsSchema, MemoryStoreParamsSchema, MemoryForgetParamsSchema, MemoryCategory, ProjectListParamsSchema, ProjectGetParamsSchema, ProjectCreateParamsSchema, ProjectStatus, TodoListParamsSchema, TodoCreateParamsSchema, TodoCompleteParamsSchema, ContactSearchParamsSchema, ContactGetParamsSchema, ContactCreateParamsSchema, } from './tools/index.js';
+export type { AutoRecallEvent, AutoRecallResult, AutoCaptureEvent, HealthCheckResult, AutoRecallHookOptions, AutoCaptureHookOptions, HealthCheckOptions, } from './hooks.js';
+export { createAutoRecallHook, createAutoCaptureHook, createHealthCheck, } from './hooks.js';
+export type { CliContext, CliCommands, CommandResult, RecallOptions, ExportOptions, StatusData, UsersData, RecallData, StatsData, ExportData, MemoryItem, } from './cli.js';
+export { createCliCommands, createStatusCommand, createUsersCommand, createRecallCommand, createStatsCommand, createExportCommand, } from './cli.js';
+export type { NotificationEvent, SubscribeParams, SubscribeResult, UnsubscribeParams, UnsubscribeResult, GetNotificationsParams, GetNotificationsResult, Notification, GatewayMethods, GatewayMethodsOptions, } from './gateway/rpc-methods.js';
+export { createGatewayMethods, registerGatewayRpcMethods, } from './gateway/rpc-methods.js';
+export type { NotificationServiceConfig, NotificationServiceEvents, NotificationServiceOptions, NotificationService, } from './services/notification-service.js';
+export { createNotificationService, } from './services/notification-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,221 @@
+/**
+ * OpenClaw Projects Plugin
+ *
+ * This plugin provides memory management, projects, todos, and contacts
+ * integration for OpenClaw agents.
+ *
+ * Supports two registration patterns:
+ * 1. OpenClaw 2026 API: `export default (api) => { ... }` (recommended)
+ * 2. Legacy API: `register(ctx)` returns plugin instance (deprecated)
+ */
+// Re-export the OpenClaw 2026 API default export
+export { default, registerOpenClaw, schemas } from './register-openclaw.js';
+import { validateConfig, validateRawConfig, resolveConfigSecrets, redactConfig, } from './config.js';
+import { createLogger } from './logger.js';
+import { createApiClient } from './api-client.js';
+import { extractContext, getUserScopeKey } from './context.js';
+import { createAutoRecallHook, createAutoCaptureHook, createHealthCheck, } from './hooks.js';
+import { createCliCommands, } from './cli.js';
+import { createMemoryRecallTool, createMemoryStoreTool, createMemoryForgetTool, createProjectListTool, createProjectGetTool, createProjectCreateTool, createTodoListTool, createTodoCreateTool, createTodoCompleteTool, createContactSearchTool, createContactGetTool, createContactCreateTool, } from './tools/index.js';
+/**
+ * Creates a plugin instance from resolved configuration.
+ * Internal helper used by both sync and async registration.
+ */
+function createPluginInstance(config, logger, runtime) {
+    // Create API client
+    const apiClient = createApiClient({ config, logger });
+    // Extract context
+    const context = extractContext(runtime);
+    // Determine user scope key based on config
+    const userId = getUserScopeKey({
+        agentId: context.agent.agentId,
+        sessionKey: context.session.sessionId,
+    }, config.userScoping);
+    // Create tools
+    const tools = {
+        memoryRecall: createMemoryRecallTool({
+            client: apiClient,
+            logger,
+            config,
+            userId,
+        }),
+        memoryStore: createMemoryStoreTool({
+            client: apiClient,
+            logger,
+            config,
+            userId,
+        }),
+        memoryForget: createMemoryForgetTool({
+            client: apiClient,
+            logger,
+            config,
+            userId,
+        }),
+        projectList: createProjectListTool({
+            client: apiClient,
+            logger,
+            config,
+            userId,
+        }),
+        projectGet: createProjectGetTool({
+            client: apiClient,
+            logger,
+            config,
+            userId,
+        }),
+        projectCreate: createProjectCreateTool({
+            client: apiClient,
+            logger,
+            config,
+            userId,
+        }),
+        todoList: createTodoListTool({
+            client: apiClient,
+            logger,
+            config,
+            userId,
+        }),
+        todoCreate: createTodoCreateTool({
+            client: apiClient,
+            logger,
+            config,
+            userId,
+        }),
+        todoComplete: createTodoCompleteTool({
+            client: apiClient,
+            logger,
+            config,
+            userId,
+        }),
+        contactSearch: createContactSearchTool({
+            client: apiClient,
+            logger,
+            config,
+            userId,
+        }),
+        contactGet: createContactGetTool({
+            client: apiClient,
+            logger,
+            config,
+            userId,
+        }),
+        contactCreate: createContactCreateTool({
+            client: apiClient,
+            logger,
+            config,
+            userId,
+        }),
+    };
+    // Create lifecycle hooks
+    const hooks = {
+        beforeAgentStart: createAutoRecallHook({
+            client: apiClient,
+            logger,
+            config,
+            userId,
+        }),
+        agentEnd: createAutoCaptureHook({
+            client: apiClient,
+            logger,
+            config,
+            userId,
+        }),
+    };
+    // Create health check
+    const healthCheck = createHealthCheck({ client: apiClient, logger });
+    // Create CLI commands
+    const cli = createCliCommands({
+        client: apiClient,
+        logger,
+        config,
+        userId,
+    });
+    logger.info('Plugin registered', {
+        agentId: context.agent.agentId,
+        sessionId: context.session.sessionId,
+        userId,
+        config: redactConfig(config),
+    });
+    return {
+        id: 'openclaw-projects',
+        name: 'OpenClaw Projects Plugin',
+        kind: 'memory',
+        config,
+        apiClient,
+        context,
+        tools,
+        hooks,
+        cli,
+        healthCheck,
+    };
+}
+/**
+ * Registers the plugin with OpenClaw (synchronous version).
+ *
+ * This function supports configurations with direct secret values only.
+ * For file or command-based secrets, use registerAsync instead.
+ *
+ * @deprecated Use registerAsync for flexible secret handling
+ */
+export function register(ctx) {
+    const logger = ctx.logger ?? createLogger('openclaw-projects');
+    // Validate as raw config first to check structure
+    const rawConfig = validateRawConfig(ctx.config);
+    // For sync registration, we require direct values - file/command refs won't work
+    // Build a resolved config from direct values only
+    const config = validateConfig({
+        apiUrl: rawConfig.apiUrl,
+        apiKey: rawConfig.apiKey ?? '',
+        twilioAccountSid: rawConfig.twilioAccountSid,
+        twilioAuthToken: rawConfig.twilioAuthToken,
+        twilioPhoneNumber: rawConfig.twilioPhoneNumber,
+        postmarkToken: rawConfig.postmarkToken,
+        postmarkFromEmail: rawConfig.postmarkFromEmail,
+        secretCommandTimeout: rawConfig.secretCommandTimeout,
+        autoRecall: rawConfig.autoRecall,
+        autoCapture: rawConfig.autoCapture,
+        userScoping: rawConfig.userScoping,
+        maxRecallMemories: rawConfig.maxRecallMemories,
+        minRecallScore: rawConfig.minRecallScore,
+        timeout: rawConfig.timeout,
+        maxRetries: rawConfig.maxRetries,
+        debug: rawConfig.debug,
+    });
+    return createPluginInstance(config, logger, ctx.runtime);
+}
+/**
+ * Registers the plugin with OpenClaw (asynchronous version).
+ *
+ * This function supports all secret loading methods:
+ * - Direct values (apiKey: "sk-xxx")
+ * - File references (apiKeyFile: "~/.secrets/api_key")
+ * - Command references (apiKeyCommand: "op read op://...")
+ *
+ * Preferred over register() for flexible secret handling.
+ */
+export async function registerAsync(ctx) {
+    const logger = ctx.logger ?? createLogger('openclaw-projects');
+    // Validate raw configuration
+    const rawConfig = validateRawConfig(ctx.config);
+    // Resolve all secrets
+    const config = await resolveConfigSecrets(rawConfig);
+    return createPluginInstance(config, logger, ctx.runtime);
+}
+/** Plugin definition object for OpenClaw */
+export const plugin = {
+    id: 'openclaw-projects',
+    name: 'OpenClaw Projects Plugin',
+    kind: 'memory',
+    register,
+};
+export { validateConfig, safeValidateConfig, validateRawConfig, safeValidateRawConfig, resolveConfigSecrets, redactConfig, } from './config.js';
+export { resolveSecret, resolveSecrets, clearSecretCache, clearCachedSecret } from './secrets.js';
+export { createLogger, redactSensitive } from './logger.js';
+export { createApiClient } from './api-client.js';
+export { extractContext, getUserScopeKey } from './context.js';
+export { createMemoryRecallTool, createMemoryStoreTool, createMemoryForgetTool, createProjectListTool, createProjectGetTool, createProjectCreateTool, createTodoListTool, createTodoCreateTool, createTodoCompleteTool, createContactSearchTool, createContactGetTool, createContactCreateTool, MemoryRecallParamsSchema, MemoryStoreParamsSchema, MemoryForgetParamsSchema, MemoryCategory, ProjectListParamsSchema, ProjectGetParamsSchema, ProjectCreateParamsSchema, ProjectStatus, TodoListParamsSchema, TodoCreateParamsSchema, TodoCompleteParamsSchema, ContactSearchParamsSchema, ContactGetParamsSchema, ContactCreateParamsSchema, } from './tools/index.js';
+export { createAutoRecallHook, createAutoCaptureHook, createHealthCheck, } from './hooks.js';
+export { createCliCommands, createStatusCommand, createUsersCommand, createRecallCommand, createStatsCommand, createExportCommand, } from './cli.js';
+export { createGatewayMethods, registerGatewayRpcMethods, } from './gateway/rpc-methods.js';
+export { createNotificationService, } from './services/notification-service.js';
+//# sourceMappingURL=index.js.map