@debian777/kairos-mcp 3.0.1-beta.14

package/dist/tools/kairos_attest.js

@@ -0,0 +1,179 @@
+import { z } from 'zod';
+import { IDGenerator } from '../services/id-generator.js';
+import { modelStats } from '../services/stats/model-stats.js';
+import { logger } from '../utils/logger.js';
+import { getToolDoc } from '../resources/embedded-mcp-resources.js';
+import { mcpToolCalls, mcpToolDuration, mcpToolErrors, mcpToolInputSize, mcpToolOutputSize } from '../services/metrics/mcp-metrics.js';
+import { getTenantId, getSpaceContextFromStorage } from '../utils/tenant-context.js';
+export function registerKairosAttestTool(server, qdrantService, options = {}) {
+    const toolName = options.toolName || 'kairos_attest';
+    const memoryUriSchema = z
+        .string()
+        .regex(/^kairos:\/\/mem\/[0-9a-f-]{36}$/i, 'must match kairos://mem/{uuid}');
+    const inputSchema = z.object({
+        uri: memoryUriSchema.describe('URI of the last step in the protocol'),
+        outcome: z.enum(['success', 'failure']).describe('Execution outcome'),
+        message: z.string().min(1).describe('Short summary of how the protocol went'),
+        quality_bonus: z.number().optional().default(0).describe('Additional quality bonus to apply'),
+        llm_model_id: z.string().optional().describe('Optional model identifier for attribution')
+    });
+    const outputSchema = z.object({
+        results: z.array(z.object({
+            uri: memoryUriSchema,
+            outcome: z.string(),
+            quality_bonus: z.number(),
+            message: z.string(),
+            rated_at: z.string()
+        })),
+        total_rated: z.number(),
+        total_failed: z.number()
+    });
+    logger.debug(`kairos_attest registration inputSchema: ${JSON.stringify(inputSchema)}`);
+    logger.debug(`kairos_attest registration outputSchema: ${JSON.stringify(outputSchema)}`);
+    server.registerTool(toolName, {
+        title: 'Finalize protocol execution',
+        description: getToolDoc('kairos_attest') || 'Stamp of completion. Call after the last step is solved via kairos_next. No final_solution required.',
+        inputSchema,
+        outputSchema
+    }, async (params) => {
+        const tenantId = getTenantId();
+        const spaceId = getSpaceContextFromStorage()?.defaultWriteSpaceId ?? 'default';
+        logger.debug(`kairos_attest space_id=${spaceId}`);
+        const inputSize = JSON.stringify(params).length;
+        mcpToolInputSize.observe({ tool: toolName, tenant_id: tenantId }, inputSize);
+        const timer = mcpToolDuration.startTimer({
+            tool: toolName,
+            tenant_id: tenantId
+        });
+        let result;
+        try {
+            const { uri, outcome, quality_bonus = 0, message, llm_model_id } = params;
+            const modelIdentity = {
+                modelId: llm_model_id || 'kairos-attest',
+                provider: 'unknown',
+                family: 'unknown'
+            };
+            if (!uri) {
+                throw new Error('uri must be a string');
+            }
+            const uris = [uri];
+            const uriArray = uris;
+            logger.tool('rate', 'rate', `single rating of ${uri} with outcome="${outcome}" model="${modelIdentity.modelId}"`);
+            const results = [];
+            let totalRated = 0;
+            let totalFailed = 0;
+            for (const uri of uriArray) {
+                try {
+                    const qdrantUuid = IDGenerator.qdrantIdFromUri(uri);
+                    const basicQualityBonus = outcome === 'success' ? 1 : -0.2;
+                    const currentPoint = await qdrantService.retrieveById(qdrantUuid);
+                    const currentMetrics = currentPoint?.payload?.quality_metrics || {};
+                    const implementationBonus = await modelStats.calculateImplementationBonus(currentMetrics, modelIdentity.modelId, outcome);
+                    const totalQualityBonus = basicQualityBonus + implementationBonus + quality_bonus;
+                    const metricsUpdate = {
+                        retrievalCount: 1,
+                        successCount: outcome === 'success' ? 1 : 0,
+                        failureCount: outcome === 'failure' ? 1 : 0,
+                        lastRated: new Date().toISOString(),
+                        lastRater: modelIdentity.modelId,
+                        qualityBonus: totalQualityBonus
+                    };
+                    if (message) {
+                        metricsUpdate.usageContext = message;
+                    }
+                    await qdrantService.updateQualityMetrics(qdrantUuid, metricsUpdate);
+                    if (currentPoint?.payload) {
+                        const { description_short, domain, task, type, tags } = currentPoint.payload;
+                        const updatedQualityMetadata = modelStats.calculateStepQualityMetadata(description_short || 'Knowledge step', domain || 'general', task || 'general', type || 'context', tags || [], outcome);
+                        await qdrantService.updateQualityMetadata(qdrantUuid, {
+                            step_quality_score: updatedQualityMetadata.step_quality_score,
+                            step_quality: updatedQualityMetadata.step_quality
+                        });
+                        logger.info(`attest: Updated quality metadata for ${uri} with execution ${outcome} - score: ${updatedQualityMetadata.step_quality_score} (${updatedQualityMetadata.step_quality})`);
+                    }
+                    await modelStats.processQualityFeedback(modelIdentity.modelId, uri, outcome, totalQualityBonus);
+                    if (implementationBonus > 0) {
+                        await modelStats.updateImplementationBonus(modelIdentity.modelId, implementationBonus);
+                    }
+                    results.push({
+                        uri: uri,
+                        outcome: outcome,
+                        quality_bonus: totalQualityBonus,
+                        message,
+                        rated_at: new Date().toISOString()
+                    });
+                    totalRated++;
+                    logger.success('rate', `rated ${uri} with ${outcome} (${totalQualityBonus} bonus)`);
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    results.push({
+                        uri: uri,
+                        outcome: outcome,
+                        quality_bonus: 0,
+                        message: `Failed to rate ${uri}: ${errorMessage}`,
+                        rated_at: new Date().toISOString(),
+                        error: errorMessage
+                    });
+                    totalFailed++;
+                    logger.error(`rate failed for ${uri}`, error);
+                }
+            }
+            result = {
+                results,
+                total_rated: totalRated,
+                total_failed: totalFailed
+            };
+            const finalResult = {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2)
+                    }],
+                structuredContent: result
+            };
+            mcpToolCalls.inc({
+                tool: toolName,
+                status: 'success',
+                tenant_id: tenantId
+            });
+            const outputSize = JSON.stringify(finalResult).length;
+            mcpToolOutputSize.observe({ tool: toolName, tenant_id: tenantId }, outputSize);
+            timer({
+                tool: toolName,
+                status: 'success',
+                tenant_id: tenantId
+            });
+            return finalResult;
+        }
+        catch (error) {
+            logger.error('attest failed', error);
+            mcpToolCalls.inc({
+                tool: toolName,
+                status: 'error',
+                tenant_id: tenantId
+            });
+            mcpToolErrors.inc({
+                tool: toolName,
+                status: 'error',
+                tenant_id: tenantId
+            });
+            timer({
+                tool: toolName,
+                status: 'error',
+                tenant_id: tenantId
+            });
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Rate failed: ${error instanceof Error ? error.message : String(error)}`
+                    }],
+                contents: [{
+                        type: 'text',
+                        text: `Rate failed: ${error instanceof Error ? error.message : String(error)}`
+                    }],
+                isError: true
+            };
+        }
+    });
+}
+//# sourceMappingURL=kairos_attest.js.map

package/dist/tools/kairos_attest.js.map

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

package/dist/tools/kairos_begin.d.ts

@@ -0,0 +1,9 @@
+import type { MemoryQdrantStore } from '../services/memory/store.js';
+import type { QdrantService } from '../services/qdrant/service.js';
+interface RegisterBeginOptions {
+    toolName?: string;
+    qdrantService?: QdrantService;
+}
+export declare function registerBeginTool(server: any, memoryStore: MemoryQdrantStore, options?: RegisterBeginOptions): void;
+export {};
+//# sourceMappingURL=kairos_begin.d.ts.map

package/dist/tools/kairos_begin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kairos_begin.d.ts","sourceRoot":"","sources":["../../src/tools/kairos_begin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAWnE,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAoED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,iBAAiB,EAAE,OAAO,GAAE,oBAAyB,QAgGhH"}

package/dist/tools/kairos_begin.js

@@ -0,0 +1,149 @@
+import { structuredLogger } from '../utils/structured-logger.js';
+import { resolveChainNextStep, resolveChainFirstStep } from '../services/chain-utils.js';
+import { getToolDoc } from '../resources/embedded-mcp-resources.js';
+import { mcpToolCalls, mcpToolDuration, mcpToolErrors, mcpToolInputSize, mcpToolOutputSize } from '../services/metrics/mcp-metrics.js';
+import { getTenantId, getSpaceContextFromStorage } from '../utils/tenant-context.js';
+import { redisCacheService } from '../services/redis-cache.js';
+import { extractMemoryBody } from '../utils/memory-body.js';
+import { buildChallenge } from './kairos_next-pow-helpers.js';
+async function loadMemoryWithCache(memoryStore, uuid) {
+    const cached = await redisCacheService.getMemoryResource(uuid);
+    if (cached) {
+        return cached;
+    }
+    const memory = await memoryStore.getMemory(uuid);
+    if (memory) {
+        await redisCacheService.setMemoryResource(memory);
+    }
+    return memory;
+}
+function normalizeMemoryUri(value) {
+    const normalized = (value || '').trim();
+    const uuid = normalized.split('/').pop();
+    if (!uuid) {
+        throw new Error('Invalid kairos://mem URI');
+    }
+    const uri = normalized.startsWith('kairos://mem/')
+        ? normalized
+        : `kairos://mem/${uuid}`;
+    return { uuid, uri };
+}
+function buildCurrentStep(memory, requestedUri) {
+    const uri = memory ? `kairos://mem/${memory.memory_uuid}` : requestedUri;
+    const content = memory ? extractMemoryBody(memory.text) : '';
+    return {
+        uri,
+        content,
+        mimeType: 'text/markdown'
+    };
+}
+function buildKairosBeginPayload(memory, requestedUri, nextStepUri, challenge, redirectMessage) {
+    const current_step = buildCurrentStep(memory, requestedUri);
+    const currentStepUri = current_step.uri;
+    const payload = {
+        must_obey: true,
+        current_step,
+        challenge: challenge ?? {}
+    };
+    if (redirectMessage) {
+        payload.message = redirectMessage;
+    }
+    if (nextStepUri) {
+        payload.next_action = `call kairos_next with ${currentStepUri} and solution matching challenge`;
+    }
+    else {
+        payload.message = 'Single-step protocol. Call kairos_attest to finalize.';
+        payload.next_action = `call kairos_attest with ${requestedUri} and outcome (success or failure) and message to complete the protocol`;
+    }
+    return payload;
+}
+import { buildBeginSchemas } from './kairos_begin_schema.js';
+export function registerBeginTool(server, memoryStore, options = {}) {
+    const toolName = options.toolName || 'kairos_begin';
+    const { inputSchema, outputSchema } = buildBeginSchemas();
+    structuredLogger.debug(`kairos_begin registration inputSchema: ${JSON.stringify(inputSchema)}`);
+    structuredLogger.debug(`kairos_begin registration outputSchema: ${JSON.stringify(outputSchema)}`);
+    server.registerTool(toolName, {
+        title: 'Start protocol execution',
+        description: getToolDoc('kairos_begin') || 'Loads step 1 and returns the first challenge. Auto-redirects to step 1 if non-step-1 URI is provided.',
+        inputSchema,
+        outputSchema
+    }, async (params) => {
+        const tenantId = getTenantId();
+        const spaceId = getSpaceContextFromStorage()?.defaultWriteSpaceId ?? 'default';
+        structuredLogger.debug(`kairos_begin space_id=${spaceId}`);
+        const inputSize = JSON.stringify(params).length;
+        mcpToolInputSize.observe({ tool: toolName, tenant_id: tenantId }, inputSize);
+        const timer = mcpToolDuration.startTimer({
+            tool: toolName,
+            tenant_id: tenantId
+        });
+        const respond = (payload) => {
+            const structured = {
+                content: [{
+                        type: 'text', text: JSON.stringify(payload)
+                    }],
+                structuredContent: payload
+            };
+            mcpToolCalls.inc({
+                tool: toolName,
+                status: 'success',
+                tenant_id: tenantId
+            });
+            const outputSize = JSON.stringify(structured).length;
+            mcpToolOutputSize.observe({ tool: toolName, tenant_id: tenantId }, outputSize);
+            timer({
+                tool: toolName,
+                status: 'success',
+                tenant_id: tenantId
+            });
+            return structured;
+        };
+        try {
+            const { uri } = params;
+            const { uuid, uri: requestedUri } = normalizeMemoryUri(uri);
+            let memory = await loadMemoryWithCache(memoryStore, uuid);
+            let redirectMessage;
+            // Auto-redirect: if not step 1, resolve and present step 1
+            if (memory?.chain && memory.chain.step_index !== 1) {
+                const firstStep = await resolveChainFirstStep(memory, options.qdrantService);
+                if (firstStep?.uuid) {
+                    const step1Memory = await loadMemoryWithCache(memoryStore, firstStep.uuid);
+                    if (step1Memory) {
+                        memory = step1Memory;
+                        redirectMessage = 'Redirected to step 1 of this protocol chain.';
+                    }
+                }
+            }
+            // Resolve next step URI
+            const nextStepInfo = memory
+                ? await resolveChainNextStep(memory, options.qdrantService)
+                : undefined;
+            const nextStepUri = nextStepInfo?.uuid
+                ? `kairos://mem/${nextStepInfo.uuid}`
+                : null;
+            const challenge = await buildChallenge(memory, memory?.proof_of_work);
+            const output = buildKairosBeginPayload(memory, requestedUri, nextStepUri, challenge, redirectMessage);
+            return respond(output);
+        }
+        catch (error) {
+            mcpToolCalls.inc({
+                tool: toolName,
+                status: 'error',
+                tenant_id: tenantId
+            });
+            mcpToolErrors.inc({
+                tool: toolName,
+                status: 'error',
+                tenant_id: tenantId
+            });
+            timer({
+                tool: toolName,
+                status: 'error',
+                tenant_id: tenantId
+            });
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=kairos_begin.js.map

package/dist/tools/kairos_begin.js.map

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

package/dist/tools/kairos_begin_schema.d.ts

@@ -0,0 +1,48 @@
+/**
+ * kairos_begin input/output schemas (zod-only, no runtime deps).
+ * V2: removed next_step, protocol_status, attest_required, final_challenge.
+ * Renamed genesis_hash -> proof_hash.
+ */
+import { z } from 'zod';
+/** Build input and output schemas for kairos_begin. */
+export declare function buildBeginSchemas(): {
+    inputSchema: z.ZodObject<{
+        uri: z.ZodString;
+    }, z.core.$strip>;
+    outputSchema: z.ZodObject<{
+        must_obey: z.ZodBoolean;
+        current_step: z.ZodNullable<z.ZodOptional<z.ZodObject<{
+            uri: z.ZodString;
+            content: z.ZodString;
+            mimeType: z.ZodLiteral<"text/markdown">;
+        }, z.core.$strip>>>;
+        challenge: z.ZodObject<{
+            type: z.ZodEnum<{
+                shell: "shell";
+                mcp: "mcp";
+                user_input: "user_input";
+                comment: "comment";
+            }>;
+            description: z.ZodString;
+            nonce: z.ZodOptional<z.ZodString>;
+            proof_hash: z.ZodOptional<z.ZodString>;
+            shell: z.ZodOptional<z.ZodObject<{
+                cmd: z.ZodString;
+                timeout_seconds: z.ZodNumber;
+            }, z.core.$strip>>;
+            mcp: z.ZodOptional<z.ZodObject<{
+                tool_name: z.ZodString;
+                expected_result: z.ZodOptional<z.ZodAny>;
+            }, z.core.$strip>>;
+            user_input: z.ZodOptional<z.ZodObject<{
+                prompt: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            comment: z.ZodOptional<z.ZodObject<{
+                min_length: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        next_action: z.ZodString;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+};
+//# sourceMappingURL=kairos_begin_schema.d.ts.map

package/dist/tools/kairos_begin_schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kairos_begin_schema.d.ts","sourceRoot":"","sources":["../../src/tools/kairos_begin_schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,uDAAuD;AACvD,wBAAgB,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuChC"}

package/dist/tools/kairos_begin_schema.js

@@ -0,0 +1,48 @@
+/**
+ * kairos_begin input/output schemas (zod-only, no runtime deps).
+ * V2: removed next_step, protocol_status, attest_required, final_challenge.
+ * Renamed genesis_hash -> proof_hash.
+ */
+import { z } from 'zod';
+const memoryUriSchema = z
+    .string()
+    .regex(/^kairos:\/\/mem\/[0-9a-f-]{36}$/i, 'must match kairos://mem/{uuid}');
+/** Build input and output schemas for kairos_begin. */
+export function buildBeginSchemas() {
+    const inputSchema = z.object({
+        uri: memoryUriSchema.describe('URI of step 1 (from kairos_search choices[].uri). Auto-redirects to step 1 if a non-step-1 URI is provided.')
+    });
+    const challengeSchema = z.object({
+        type: z.enum(['shell', 'mcp', 'user_input', 'comment']),
+        description: z.string(),
+        nonce: z.string().optional().describe('Echo back as solution.nonce'),
+        proof_hash: z.string().optional().describe('Echo back as solution.proof_hash'),
+        shell: z.object({
+            cmd: z.string(),
+            timeout_seconds: z.number()
+        }).optional(),
+        mcp: z.object({
+            tool_name: z.string(),
+            expected_result: z.any().optional()
+        }).optional(),
+        user_input: z.object({
+            prompt: z.string().optional()
+        }).optional(),
+        comment: z.object({
+            min_length: z.number().optional()
+        }).optional()
+    });
+    const outputSchema = z.object({
+        must_obey: z.boolean().describe('Always true for kairos_begin'),
+        current_step: z.object({
+            uri: memoryUriSchema,
+            content: z.string(),
+            mimeType: z.literal('text/markdown')
+        }).optional().nullable(),
+        challenge: challengeSchema,
+        next_action: z.string().describe('Next tool call with embedded kairos://mem/ URI'),
+        message: z.string().optional()
+    });
+    return { inputSchema, outputSchema };
+}
+//# sourceMappingURL=kairos_begin_schema.js.map

package/dist/tools/kairos_begin_schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kairos_begin_schema.js","sourceRoot":"","sources":["../../src/tools/kairos_begin_schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,eAAe,GAAG,CAAC;KACtB,MAAM,EAAE;KACR,KAAK,CAAC,kCAAkC,EAAE,gCAAgC,CAAC,CAAC;AAE/E,uDAAuD;AACvD,MAAM,UAAU,iBAAiB;IAC/B,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;QAC3B,GAAG,EAAE,eAAe,CAAC,QAAQ,CAAC,6GAA6G,CAAC;KAC7I,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;QAC/B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;QACvD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QACpE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QAC9E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;YACf,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;SAC5B,CAAC,CAAC,QAAQ,EAAE;QACb,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC;YACZ,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,eAAe,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;SACpC,CAAC,CAAC,QAAQ,EAAE;QACb,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC9B,CAAC,CAAC,QAAQ,EAAE;QACb,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;YAChB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAClC,CAAC,CAAC,QAAQ,EAAE;KACd,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;QAC5B,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QAC/D,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,GAAG,EAAE,eAAe;YACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;YACnB,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;SACrC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QACxB,SAAS,EAAE,eAAe;QAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;QAClF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC/B,CAAC,CAAC;IAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;AACvC,CAAC"}

package/dist/tools/kairos_delete.d.ts

@@ -0,0 +1,2 @@
+export declare function registerKairosDeleteTool(server: any, toolName?: string): void;
+//# sourceMappingURL=kairos_delete.d.ts.map

package/dist/tools/kairos_delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kairos_delete.d.ts","sourceRoot":"","sources":["../../src/tools/kairos_delete.ts"],"names":[],"mappings":"AAMA,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,SAAkB,QAyH/E"}

package/dist/tools/kairos_delete.js

@@ -0,0 +1,113 @@
+import { z } from 'zod';
+import { qdrantService } from '../services/qdrant/index.js';
+import { getToolDoc } from '../resources/embedded-mcp-resources.js';
+import { mcpToolCalls, mcpToolDuration, mcpToolErrors, mcpToolInputSize, mcpToolOutputSize } from '../services/metrics/mcp-metrics.js';
+import { getTenantId } from '../utils/tenant-context.js';
+export function registerKairosDeleteTool(server, toolName = 'kairos_delete') {
+    const memoryUriSchema = z
+        .string()
+        .regex(/^kairos:\/\/mem\/[0-9a-f-]{36}$/i, 'must match kairos://mem/{uuid}');
+    server.registerTool(toolName, {
+        title: 'Delete KAIROS Memory',
+        description: getToolDoc('kairos_delete'),
+        inputSchema: z.object({
+            uris: z
+                .array(memoryUriSchema)
+                .nonempty()
+                .describe('Non-empty array of kairos://mem/{uuid} URIs to delete')
+        }),
+        outputSchema: z.object({
+            results: z.array(z.object({
+                uri: memoryUriSchema,
+                status: z.enum(['deleted', 'error']),
+                message: z.string()
+            })),
+            total_deleted: z.number(),
+            total_failed: z.number()
+        })
+    }, async (params) => {
+        const tenantId = getTenantId();
+        const inputSize = JSON.stringify(params).length;
+        mcpToolInputSize.observe({ tool: toolName, tenant_id: tenantId }, inputSize);
+        const timer = mcpToolDuration.startTimer({
+            tool: toolName,
+            tenant_id: tenantId
+        });
+        let result;
+        try {
+            const { uris } = params || {};
+            if (!Array.isArray(uris) || uris.length === 0) {
+                throw new Error('uris must be a non-empty array of strings');
+            }
+            const uriArray = uris;
+            const results = [];
+            let totalDeleted = 0;
+            let totalFailed = 0;
+            for (const uri of uriArray) {
+                try {
+                    const uuid = typeof uri === 'string' ? uri.split('/').pop() : undefined;
+                    if (!uuid) {
+                        throw new Error('Invalid URI format');
+                    }
+                    await qdrantService.deleteMemory(uuid);
+                    results.push({
+                        uri,
+                        status: 'deleted',
+                        message: `Memory ${uri} deleted successfully`
+                    });
+                    totalDeleted++;
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    results.push({
+                        uri,
+                        status: 'error',
+                        message: `Failed to delete memory: ${errorMessage}`
+                    });
+                    totalFailed++;
+                }
+            }
+            result = {
+                results,
+                total_deleted: totalDeleted,
+                total_failed: totalFailed
+            };
+            const finalResult = {
+                content: [{ type: 'text', text: JSON.stringify(result) }],
+                structuredContent: result
+            };
+            mcpToolCalls.inc({
+                tool: toolName,
+                status: 'success',
+                tenant_id: tenantId
+            });
+            const outputSize = JSON.stringify(finalResult).length;
+            mcpToolOutputSize.observe({ tool: toolName, tenant_id: tenantId }, outputSize);
+            timer({
+                tool: toolName,
+                status: 'success',
+                tenant_id: tenantId
+            });
+            return finalResult;
+        }
+        catch (error) {
+            mcpToolCalls.inc({
+                tool: toolName,
+                status: 'error',
+                tenant_id: tenantId
+            });
+            mcpToolErrors.inc({
+                tool: toolName,
+                status: 'error',
+                tenant_id: tenantId
+            });
+            timer({
+                tool: toolName,
+                status: 'error',
+                tenant_id: tenantId
+            });
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=kairos_delete.js.map

package/dist/tools/kairos_delete.js.map

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

package/dist/tools/kairos_dump.d.ts

@@ -0,0 +1,14 @@
+import type { MemoryQdrantStore } from '../services/memory/store.js';
+import type { QdrantService } from '../services/qdrant/service.js';
+export interface DumpParams {
+    uri: string;
+    protocol?: boolean;
+}
+/** Execute dump logic; used by MCP tool and HTTP API. */
+export declare function executeDump(memoryStore: MemoryQdrantStore, qdrantService: QdrantService | undefined, params: DumpParams): Promise<Record<string, unknown>>;
+export interface RegisterDumpOptions {
+    toolName?: string;
+    qdrantService?: QdrantService;
+}
+export declare function registerKairosDumpTool(server: any, memoryStore: MemoryQdrantStore, options?: RegisterDumpOptions): void;
+//# sourceMappingURL=kairos_dump.d.ts.map

package/dist/tools/kairos_dump.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kairos_dump.d.ts","sourceRoot":"","sources":["../../src/tools/kairos_dump.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AA0DnE,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,yDAAyD;AACzD,wBAAsB,WAAW,CAC/B,WAAW,EAAE,iBAAiB,EAC9B,aAAa,EAAE,aAAa,GAAG,SAAS,EACxC,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA6DlC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,GAAG,EACX,WAAW,EAAE,iBAAiB,EAC9B,OAAO,GAAE,mBAAwB,QAuClC"}