sqlew 4.3.1 → 5.0.0

package/dist/backend/local-backend.js

@@ -0,0 +1,410 @@
+/**
+ * LocalBackend - Direct database connection via Knex
+ *
+ * This backend executes tool actions directly against the local database.
+ * All existing tool logic is wrapped here for the ToolBackend abstraction.
+ */
+import { getAdapter } from '../database.js';
+import { setDecision, getContext, getDecision, searchByTags, getVersions, searchByLayer, quickSetDecision, searchAdvanced, setDecisionBatch, hasUpdates, setFromTemplate, createTemplate, listTemplates, hardDeleteDecision, addDecisionContextAction, listDecisionContextsAction, handleAnalytics, decisionHelp, decisionExample } from '../tools/context/index.js';
+import { addConstraint, getConstraints, activateConstraint, deactivateConstraint, suggestPendingConstraints, constraintHelp, constraintExample, activateConstraintsByTag } from '../tools/constraints/index.js';
+import { queryAction, queryParams, queryTool, workflowHints, batchGuide, errorRecovery, helpHelp, helpExample } from '../tools/help/index.js';
+import { getUseCase, searchUseCases, listAllUseCases, useCaseHelp, useCaseExample } from '../tools/use_case/index.js';
+import { getExample, searchExamples, listAllExamples, exampleHelp, exampleExample } from '../tools/example/index.js';
+import { trackAndReturnHelp } from '../utils/help-tracking.js';
+import { handleSuggestAction } from '../tools/suggest/index.js';
+import { listQueue, clearQueue, removeFromQueue } from '../tools/queue/index.js';
+import { getHelpLoader } from '../help-loader.js';
+import { ProjectContext } from '../utils/project-context.js';
+/**
+ * LocalBackend implementation
+ *
+ * Wraps all existing tool logic for the ToolBackend abstraction.
+ */
+export class LocalBackend {
+    backendType = 'local';
+    /**
+     * Execute a tool action against the local database
+     */
+    async execute(tool, action, params) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const p = params;
+        let result;
+        switch (tool) {
+            case 'decision':
+                result = await this.executeDecision(action, p);
+                break;
+            case 'constraint':
+                result = await this.executeConstraint(action, p);
+                break;
+            case 'help':
+                result = await this.executeHelp(action, p);
+                break;
+            case 'example':
+                result = await this.executeExample(action, p);
+                break;
+            case 'use_case':
+                result = await this.executeUseCase(action, p);
+                break;
+            case 'suggest':
+                result = await handleSuggestAction(p);
+                break;
+            case 'queue':
+                result = this.executeQueue(action, p);
+                break;
+            default:
+                throw new Error(`Unknown tool: ${tool}`);
+        }
+        return result;
+    }
+    /**
+     * Health check - verify database connection
+     */
+    async healthCheck() {
+        const start = Date.now();
+        try {
+            const adapter = getAdapter();
+            // Simple query to verify connection
+            await adapter.getKnex().raw('SELECT 1');
+            return {
+                ok: true,
+                latency: Date.now() - start,
+            };
+        }
+        catch (error) {
+            return {
+                ok: false,
+                latency: Date.now() - start,
+                message: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Disconnect from database
+     */
+    async disconnect() {
+        try {
+            const adapter = getAdapter();
+            await adapter.disconnect();
+        }
+        catch (error) {
+            // Ignore "not initialized" errors - nothing to disconnect
+            if (error instanceof Error && error.message.includes('not initialized')) {
+                return;
+            }
+            throw error;
+        }
+    }
+    // ========== Private execute methods for each tool ==========
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async executeDecision(action, params) {
+        switch (action) {
+            case 'set': return await setDecision(params);
+            case 'get': return await getDecision(params);
+            case 'list': return await getContext(params);
+            case 'search_tags': return await searchByTags({
+                tags: params.tags,
+                match_mode: params.tag_match,
+                status: params.status,
+                layer: params.layer
+            });
+            case 'search_layer': return await searchByLayer({
+                layer: params.layer,
+                status: params.status,
+                include_tags: params.include_tags
+            });
+            case 'versions': return await getVersions(params);
+            case 'quick_set': return await quickSetDecision(params);
+            case 'search_advanced': return await searchAdvanced({
+                layers: params.layers,
+                tags_all: params.tags_all,
+                tags_any: params.tags_any,
+                exclude_tags: params.exclude_tags,
+                scopes: params.scopes,
+                updated_after: params.updated_after,
+                updated_before: params.updated_before,
+                decided_by: params.decided_by,
+                statuses: params.statuses,
+                search_text: params.search_text,
+                sort_by: params.sort_by,
+                sort_order: params.sort_order,
+                limit: params.limit,
+                offset: params.offset
+            });
+            case 'set_batch': {
+                let decisions = params.decisions;
+                if (typeof decisions === 'string') {
+                    try {
+                        decisions = JSON.parse(decisions);
+                    }
+                    catch (error) {
+                        throw new Error(`Invalid JSON in "decisions" parameter: ${error instanceof Error ? error.message : String(error)}`);
+                    }
+                }
+                return await setDecisionBatch({ decisions, atomic: params.atomic });
+            }
+            case 'has_updates': return await hasUpdates({
+                agent_name: params.agent_name,
+                since_timestamp: params.since_timestamp
+            });
+            // Policy actions (v3.9.0 - renamed from template actions)
+            case 'create_policy': return await createTemplate(params);
+            case 'list_policies': return await listTemplates(params);
+            case 'set_from_policy': return await setFromTemplate(params);
+            // Template actions (backward compatibility)
+            case 'set_from_template': return await setFromTemplate(params);
+            case 'create_template': return await createTemplate(params);
+            case 'list_templates': return await listTemplates(params);
+            case 'hard_delete': return await hardDeleteDecision(params);
+            case 'add_decision_context': return await addDecisionContextAction(params);
+            case 'list_decision_contexts': return await listDecisionContextsAction(params);
+            case 'analytics': return await handleAnalytics(params);
+            case 'export':
+                // SaaS-only feature - LocalBackend cannot provide export data
+                throw new Error('Export feature is SaaS-only. ' +
+                    'To use document export, connect to sqlew SaaS (set SQLEW_API_KEY). ' +
+                    'For local JSON backup, use: npm run db:export');
+            case 'help': {
+                const helpContent = decisionHelp();
+                trackAndReturnHelp('decision', 'help', JSON.stringify(helpContent));
+                return helpContent;
+            }
+            case 'example': {
+                const exampleContent = decisionExample();
+                trackAndReturnHelp('decision', 'example', JSON.stringify(exampleContent));
+                return exampleContent;
+            }
+            case 'use_case': {
+                return await listAllUseCases({
+                    action: 'list_all',
+                    category: params.category,
+                    complexity: params.complexity,
+                    limit: params.limit,
+                    offset: params.offset
+                });
+            }
+            default: throw new Error(`Unknown decision action: ${action}`);
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async executeConstraint(action, params) {
+        switch (action) {
+            case 'add': return await addConstraint(params);
+            case 'get': return await getConstraints(params);
+            case 'activate': return await activateConstraint(params);
+            case 'activate_by_tag': return await activateConstraintsByTag(params.tag);
+            case 'deactivate': return await deactivateConstraint(params);
+            case 'suggest_pending': return await suggestPendingConstraints(params);
+            case 'help': {
+                const constraintHelpContent = constraintHelp();
+                trackAndReturnHelp('constraint', 'help', JSON.stringify(constraintHelpContent));
+                return constraintHelpContent;
+            }
+            case 'example': {
+                const constraintExampleContent = constraintExample();
+                trackAndReturnHelp('constraint', 'example', JSON.stringify(constraintExampleContent));
+                return constraintExampleContent;
+            }
+            case 'use_case': {
+                return await listAllUseCases({
+                    action: 'list_all',
+                    category: params.category,
+                    complexity: params.complexity,
+                    limit: params.limit,
+                    offset: params.offset
+                });
+            }
+            default: throw new Error(`Unknown constraint action: ${action}`);
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async executeHelp(action, params) {
+        switch (action) {
+            case 'query_action':
+                if (!params.tool || !params.target_action) {
+                    return { error: 'Parameters "tool" and "target_action" are required for query_action' };
+                }
+                return await queryAction({ action: 'query_action', tool: params.tool, target_action: params.target_action });
+            case 'query_params':
+                if (!params.tool || !params.target_action) {
+                    return { error: 'Parameters "tool" and "target_action" are required for query_params' };
+                }
+                return await queryParams({ action: 'query_params', tool: params.tool, target_action: params.target_action });
+            case 'query_tool':
+                if (!params.tool) {
+                    return { error: 'Parameter "tool" is required for query_tool' };
+                }
+                return await queryTool({ action: 'query_tool', tool: params.tool });
+            case 'workflow_hints':
+                if (!params.tool || !params.current_action) {
+                    return { error: 'Parameters "tool" and "current_action" are required for workflow_hints' };
+                }
+                return await workflowHints({ action: 'workflow_hints', tool: params.tool, current_action: params.current_action });
+            case 'batch_guide':
+                if (!params.operation) {
+                    return { error: 'Parameter "operation" is required for batch_guide' };
+                }
+                return await batchGuide({ action: 'batch_guide', operation: params.operation });
+            case 'error_recovery':
+                if (!params.error_message) {
+                    return { error: 'Parameter "error_message" is required for error_recovery' };
+                }
+                return await errorRecovery({
+                    action: 'error_recovery',
+                    error_message: params.error_message,
+                    tool: params.tool
+                });
+            case 'help': {
+                const helpHelpContent = helpHelp();
+                trackAndReturnHelp('help', 'help', JSON.stringify(helpHelpContent));
+                return helpHelpContent;
+            }
+            case 'example': {
+                const helpExampleContent = helpExample();
+                trackAndReturnHelp('help', 'example', JSON.stringify(helpExampleContent));
+                return helpExampleContent;
+            }
+            default: throw new Error(`Unknown help action: ${action}`);
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async executeExample(action, params) {
+        switch (action) {
+            case 'get':
+                return await getExample({
+                    action: 'get',
+                    tool: params.tool,
+                    action_name: params.action_name,
+                    topic: params.topic
+                });
+            case 'search':
+                if (!params.keyword) {
+                    return { error: 'Parameter "keyword" is required for search' };
+                }
+                return await searchExamples({
+                    action: 'search',
+                    keyword: params.keyword,
+                    tool: params.tool,
+                    action_name: params.action_name,
+                    complexity: params.complexity
+                });
+            case 'list_all':
+                return await listAllExamples({
+                    action: 'list_all',
+                    tool: params.tool,
+                    complexity: params.complexity,
+                    limit: params.limit,
+                    offset: params.offset
+                });
+            case 'help': {
+                const exampleHelpContent = exampleHelp();
+                trackAndReturnHelp('example', 'help', JSON.stringify(exampleHelpContent));
+                return exampleHelpContent;
+            }
+            case 'example': {
+                const exampleExampleContent = exampleExample();
+                trackAndReturnHelp('example', 'example', JSON.stringify(exampleExampleContent));
+                return exampleExampleContent;
+            }
+            default: throw new Error(`Unknown example action: ${action}`);
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async executeUseCase(action, params) {
+        switch (action) {
+            case 'get':
+                if (!params.use_case_id) {
+                    return { error: 'Parameter "use_case_id" is required for get' };
+                }
+                return await getUseCase({ action: 'get', use_case_id: params.use_case_id });
+            case 'search':
+                if (!params.keyword) {
+                    return { error: 'Parameter "keyword" is required for search' };
+                }
+                return await searchUseCases({
+                    action: 'search',
+                    keyword: params.keyword,
+                    category: params.category,
+                    complexity: params.complexity
+                });
+            case 'list_all':
+                return await listAllUseCases({
+                    action: 'list_all',
+                    category: params.category,
+                    complexity: params.complexity,
+                    limit: params.limit,
+                    offset: params.offset
+                });
+            case 'help': {
+                const useCaseHelpContent = useCaseHelp();
+                trackAndReturnHelp('use_case', 'help', JSON.stringify(useCaseHelpContent));
+                return useCaseHelpContent;
+            }
+            case 'example': {
+                const useCaseExampleContent = useCaseExample();
+                trackAndReturnHelp('use_case', 'example', JSON.stringify(useCaseExampleContent));
+                return useCaseExampleContent;
+            }
+            default: throw new Error(`Unknown use_case action: ${action}`);
+        }
+    }
+    /**
+     * Get project root path for file-based operations
+     *
+     * Priority: ProjectContext.project_root_path > process.cwd()
+     */
+    getProjectRoot() {
+        const ctx = ProjectContext.getInstance();
+        if (ctx.isInitialized()) {
+            return ctx.getProjectMetadata().project_root_path || process.cwd();
+        }
+        return process.cwd();
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async executeQueue(action, params) {
+        const projectRoot = this.getProjectRoot();
+        switch (action) {
+            case 'list':
+                return listQueue(projectRoot, params);
+            case 'clear':
+                return clearQueue(projectRoot, params);
+            case 'remove':
+                return removeFromQueue(projectRoot, params);
+            case 'help': {
+                const loader = await getHelpLoader();
+                const tool = loader.getTool('queue');
+                if (!tool) {
+                    return { error: 'Queue help not found' };
+                }
+                const helpContent = {
+                    tool: tool.name,
+                    description: tool.description,
+                    actions: tool.actions.map(a => ({
+                        name: a.name,
+                        description: a.description,
+                        params: a.params,
+                    })),
+                };
+                trackAndReturnHelp('queue', 'help', JSON.stringify(helpContent));
+                return helpContent;
+            }
+            case 'example': {
+                const loader = await getHelpLoader();
+                const tool = loader.getTool('queue');
+                if (!tool) {
+                    return { error: 'Queue examples not found' };
+                }
+                const exampleContent = {
+                    tool: tool.name,
+                    examples: tool.actions.flatMap(a => a.examples.map(ex => ({
+                        action: a.name,
+                        ...ex,
+                    }))),
+                };
+                trackAndReturnHelp('queue', 'example', JSON.stringify(exampleContent));
+                return exampleContent;
+            }
+            default: throw new Error(`Unknown queue action: ${action}`);
+        }
+    }
+}
+//# sourceMappingURL=local-backend.js.map

package/dist/backend/local-backend.js.map

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

package/dist/backend/transforming-backend.d.ts

@@ -0,0 +1,47 @@
+/**
+ * TransformingBackend - Decorator pattern for action transformation
+ *
+ * Wraps a backend (typically SaaS) and transforms specific actions
+ * before delegating to the wrapped backend.
+ *
+ * Use Case: SaaS backend doesn't support quick_set, so we:
+ * 1. Apply inference logic locally (layer/tags/scope from key)
+ * 2. Transform to 'set' action
+ * 3. Forward to wrapped SaaS backend
+ *
+ * @since v5.0.1
+ */
+import type { ToolBackend, HealthCheckResult, BackendType } from './types.js';
+/**
+ * TransformingBackend implementation
+ *
+ * Implements ToolBackend interface while wrapping another backend.
+ * Transforms specific actions (like quick_set) before delegation.
+ */
+export declare class TransformingBackend implements ToolBackend {
+    private wrapped;
+    readonly backendType: BackendType;
+    readonly pluginName?: string;
+    constructor(wrapped: ToolBackend);
+    /**
+     * Execute a tool action, transforming if necessary
+     */
+    execute<T>(tool: string, action: string, params: Record<string, unknown>): Promise<T>;
+    /**
+     * Handle quick_set by inferring params and calling set
+     */
+    private handleQuickSet;
+    /**
+     * Delegate health check to wrapped backend
+     */
+    healthCheck(): Promise<HealthCheckResult>;
+    /**
+     * Delegate disconnect to wrapped backend
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Delegate setAgentName to wrapped backend
+     */
+    setAgentName(name: string): void;
+}
+//# sourceMappingURL=transforming-backend.d.ts.map

package/dist/backend/transforming-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforming-backend.d.ts","sourceRoot":"","sources":["../../src/backend/transforming-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAa9E;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,WAAW;IAIzC,OAAO,CAAC,OAAO;IAH3B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAET,OAAO,EAAE,WAAW;IAKxC;;OAEG;IACG,OAAO,CAAC,CAAC,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,CAAC,CAAC;IAUb;;OAEG;YACW,cAAc;IAsB5B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAI/C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAKjC"}

package/dist/backend/transforming-backend.js

@@ -0,0 +1,80 @@
+/**
+ * TransformingBackend - Decorator pattern for action transformation
+ *
+ * Wraps a backend (typically SaaS) and transforms specific actions
+ * before delegating to the wrapped backend.
+ *
+ * Use Case: SaaS backend doesn't support quick_set, so we:
+ * 1. Apply inference logic locally (layer/tags/scope from key)
+ * 2. Transform to 'set' action
+ * 3. Forward to wrapped SaaS backend
+ *
+ * @since v5.0.1
+ */
+import { inferDecisionParams } from './inference.js';
+/**
+ * TransformingBackend implementation
+ *
+ * Implements ToolBackend interface while wrapping another backend.
+ * Transforms specific actions (like quick_set) before delegation.
+ */
+export class TransformingBackend {
+    wrapped;
+    backendType;
+    pluginName;
+    constructor(wrapped) {
+        this.wrapped = wrapped;
+        this.backendType = wrapped.backendType;
+        this.pluginName = wrapped.pluginName;
+    }
+    /**
+     * Execute a tool action, transforming if necessary
+     */
+    async execute(tool, action, params) {
+        // Transform decision.quick_set → decision.set with inference
+        if (tool === 'decision' && action === 'quick_set') {
+            return await this.handleQuickSet(params);
+        }
+        // Pass through to wrapped backend for all other actions
+        return this.wrapped.execute(tool, action, params);
+    }
+    /**
+     * Handle quick_set by inferring params and calling set
+     */
+    async handleQuickSet(params) {
+        // Apply inference logic
+        const { transformedParams, inferred } = inferDecisionParams(params);
+        // Call wrapped backend with 'set' action
+        const result = await this.wrapped.execute('decision', 'set', transformedParams);
+        // Return quick_set response format
+        return {
+            success: result.success,
+            key: result.key,
+            key_id: result.key_id,
+            version: result.version,
+            inferred,
+            message: `Decision "${params.key}" set successfully with smart defaults`,
+        };
+    }
+    /**
+     * Delegate health check to wrapped backend
+     */
+    async healthCheck() {
+        return this.wrapped.healthCheck();
+    }
+    /**
+     * Delegate disconnect to wrapped backend
+     */
+    async disconnect() {
+        return this.wrapped.disconnect();
+    }
+    /**
+     * Delegate setAgentName to wrapped backend
+     */
+    setAgentName(name) {
+        if (this.wrapped.setAgentName) {
+            this.wrapped.setAgentName(name);
+        }
+    }
+}
+//# sourceMappingURL=transforming-backend.js.map

package/dist/backend/transforming-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforming-backend.js","sourceRoot":"","sources":["../../src/backend/transforming-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAYrD;;;;;GAKG;AACH,MAAM,OAAO,mBAAmB;IAIV;IAHX,WAAW,CAAc;IACzB,UAAU,CAAU;IAE7B,YAAoB,OAAoB;QAApB,YAAO,GAAP,OAAO,CAAa;QACtC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,IAAY,EACZ,MAAc,EACd,MAA+B;QAE/B,6DAA6D;QAC7D,IAAI,IAAI,KAAK,UAAU,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YAClD,OAAO,MAAM,IAAI,CAAC,cAAc,CAAI,MAAM,CAAC,CAAC;QAC9C,CAAC;QAED,wDAAwD;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAI,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAAI,MAA+B;QAC7D,wBAAwB;QACxB,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAEpE,yCAAyC;QACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CACvC,UAAU,EACV,KAAK,EACL,iBAAiB,CAClB,CAAC;QAEF,mCAAmC;QACnC,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ;YACR,OAAO,EAAE,aAAa,MAAM,CAAC,GAAG,wCAAwC;SACzD,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,IAAY;QACvB,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YAC9B,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;CACF"}

package/dist/backend/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Backend Abstraction Types
+ *
+ * Defines the ToolBackend interface for local and SaaS backends.
+ */
+/**
+ * Backend type identifier
+ * - 'local': Direct database connection via Knex
+ * - 'saas': SaaS connector (submodule)
+ */
+export type BackendType = 'local' | 'saas';
+/**
+ * Health check result
+ */
+export interface HealthCheckResult {
+    ok: boolean;
+    latency: number;
+    message?: string;
+}
+/**
+ * ToolBackend interface
+ *
+ * All backend implementations must implement this interface.
+ * This enables transparent switching between local DB and plugin-based backends.
+ */
+export interface ToolBackend {
+    /**
+     * Execute a tool action
+     * @param tool - Tool name (e.g., 'decision', 'constraint')
+     * @param action - Action name (e.g., 'get', 'set', 'list')
+     * @param params - Action parameters
+     * @returns Action result
+     */
+    execute<TResponse = unknown>(tool: string, action: string, params: Record<string, unknown>): Promise<TResponse>;
+    /**
+     * Perform health check
+     * @returns Health check result with latency
+     */
+    healthCheck(): Promise<HealthCheckResult>;
+    /**
+     * Disconnect and cleanup resources
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Backend type identifier
+     */
+    readonly backendType: BackendType;
+    /**
+     * Optional: Plugin name (for plugin backends)
+     */
+    readonly pluginName?: string;
+    /**
+     * Optional: Set agent name for audit headers (SaaS only)
+     * @param name - MCP client name (e.g., "claude-code")
+     */
+    setAgentName?(name: string): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/backend/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/backend/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,OAAO,CAAC,SAAS,GAAG,OAAO,EACzB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,SAAS,CAAC,CAAC;IAEtB;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE1C;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,YAAY,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC"}

package/dist/backend/types.js

@@ -0,0 +1,7 @@
+/**
+ * Backend Abstraction Types
+ *
+ * Defines the ToolBackend interface for local and SaaS backends.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/backend/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/backend/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}