@squadrules/mcp 4.8.6

package/dist/services/stats/scoring.js

@@ -0,0 +1,102 @@
+/**
+ * Core quality scoring algorithms extracted from ModelStatsService.
+ * Pure functions that compute component scores and aggregate quality.
+ */
+export function calculateSpecificity(description, task, type) {
+    let score = 5;
+    const specificTerms = ['ECONNREFUSED', 'healthcheck', 'strict mode', 'JWT', 'middleware'];
+    if (specificTerms.some(term => description.toLowerCase().includes(term)))
+        score += 2;
+    if (description.toLowerCase().includes('error') && task.toLowerCase().includes('troubleshooting'))
+        score += 1;
+    if (type === 'pattern' && task.toLowerCase().includes('configuration'))
+        score += 1;
+    return Math.min(10, score);
+}
+export function calculateExpertValue(task, tags) {
+    let score = 5;
+    const expertDomains = ['security', 'docker', 'kubernetes', 'typescript', 'postgresql'];
+    if (expertDomains.some(d => tags.includes(d) || task.toLowerCase().includes(d)))
+        score += 2;
+    const expertTasks = ['optimization', 'security', 'troubleshooting', 'error-handling'];
+    if (expertTasks.some(expertTask => task.toLowerCase().includes(expertTask)))
+        score += 1;
+    const expertTags = ['timing-attack', 'race-condition', 'performance', 'null-safety'];
+    if (expertTags.some(expertTag => tags.includes(expertTag)))
+        score += 1;
+    return Math.min(10, score);
+}
+export function calculateBroadUtility(task, tags) {
+    let score = 5;
+    const universalDomains = ['typescript', 'javascript', 'docker', 'postgresql'];
+    if (universalDomains.some(u => tags.includes(u) || task.toLowerCase().includes(u)))
+        score += 2;
+    const utilityTasks = ['configuration', 'error-handling', 'best-practices'];
+    if (utilityTasks.some(utilityTask => task.toLowerCase().includes(utilityTask)))
+        score += 1;
+    const commonTags = ['configuration', 'error-handling', 'best-practices'];
+    if (commonTags.some(commonTag => tags.includes(commonTag)))
+        score += 1;
+    return Math.min(10, score);
+}
+export function calculateLongevity(description, type) {
+    let score = 5;
+    const desc = description.toLowerCase();
+    if (desc.includes('typescript') || desc.includes('docker') || desc.includes('postgresql'))
+        score += 2;
+    if (type === 'rule' || type === 'pattern')
+        score += 1;
+    if (desc.includes('experimental') || desc.includes('beta'))
+        score -= 2;
+    return Math.max(0, Math.min(10, score));
+}
+export function determineQuality(total) {
+    if (total >= 30)
+        return 'excellent';
+    if (total >= 25)
+        return 'high';
+    if (total >= 20)
+        return 'standard';
+    if (total >= 15)
+        return 'basic';
+    return 'below_threshold';
+}
+export function calculateQualityScore(description, task, type, tags) {
+    const specificity = calculateSpecificity(description, task, type);
+    const expertValue = calculateExpertValue(task, tags);
+    const broadUtility = calculateBroadUtility(task, tags);
+    const longevity = calculateLongevity(description, type);
+    const total = specificity + expertValue + broadUtility + longevity;
+    const quality = determineQuality(total);
+    return { specificity, expertValue, broadUtility, longevity, total, quality };
+}
+/**
+ * Calculate step-level quality metadata.
+ */
+export function calculateStepQualityMetadata(description, domain, task, type, tags, executionSuccess) {
+    const qualityScore = calculateQualityScore(description, task, type, tags);
+    let executionMultiplier = 1.0;
+    if (executionSuccess === 'success')
+        executionMultiplier = 3.0;
+    else if (executionSuccess === 'partial')
+        executionMultiplier = 1.5;
+    else if (executionSuccess === 'failure')
+        executionMultiplier = 0.5;
+    const baseScore = Math.max(1, Math.round(qualityScore.total / 10));
+    const stepQualityScore = Math.round(baseScore * executionMultiplier);
+    const adjustedScore = qualityScore.total * executionMultiplier;
+    let stepQuality;
+    if (adjustedScore >= 60 || (executionSuccess === 'success' && adjustedScore >= 40))
+        stepQuality = 'excellent';
+    else if (adjustedScore >= 35 || (executionSuccess === 'success' && adjustedScore >= 25))
+        stepQuality = 'high';
+    else if (adjustedScore >= 20)
+        stepQuality = 'standard';
+    else
+        stepQuality = 'basic';
+    return {
+        step_quality_score: stepQualityScore,
+        step_quality: stepQuality
+    };
+}
+//# sourceMappingURL=scoring.js.map

package/dist/services/stats/scoring.js.map

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

package/dist/services/stats/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Stats types and interfaces for Model Statistics
+ *
+ * Extracted from the original monolithic implementation to allow
+ * modularization of scoring, statistics, and helpers.
+ */
+export interface QualityScore {
+    specificity: number;
+    expertValue: number;
+    broadUtility: number;
+    longevity: number;
+    total: number;
+    quality: 'excellent' | 'high' | 'standard' | 'basic' | 'below_threshold';
+}
+export interface ModelStats {
+    totalContributions: number;
+    excellentContributions: number;
+    highContributions: number;
+    standardContributions: number;
+    basicContributions: number;
+    lastUpdated: Date;
+}
+export interface RecentDiscovery {
+    agent: string;
+    title: string;
+    score: number;
+    quality: string;
+    timestamp: Date;
+}
+export interface StatsState {
+    recentDiscoveries: RecentDiscovery[];
+    implementationBonuses: {
+        [llm_model_id: string]: number;
+    };
+    healerBonuses: {
+        [llm_model_id: string]: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/stats/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/stats/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,iBAAiB,CAAC;CAC5E;AAED,MAAM,WAAW,UAAU;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACvB,iBAAiB,EAAE,eAAe,EAAE,CAAC;IACrC,qBAAqB,EAAE;QAAE,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAC1D,aAAa,EAAE;QAAE,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACrD"}

package/dist/services/stats/types.js

@@ -0,0 +1,8 @@
+/**
+ * Stats types and interfaces for Model Statistics
+ *
+ * Extracted from the original monolithic implementation to allow
+ * modularization of scoring, statistics, and helpers.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/stats/types.js.map

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

package/dist/stdio/stdio-server.d.ts

@@ -0,0 +1,3 @@
+import { MemoryQdrantStore } from '../services/memory/store.js';
+export declare function startStdioTransport(memoryStore: MemoryQdrantStore): Promise<void>;
+//# sourceMappingURL=stdio-server.d.ts.map

package/dist/stdio/stdio-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-server.d.ts","sourceRoot":"","sources":["../../src/stdio/stdio-server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAIhE,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQvF"}

package/dist/stdio/stdio-server.js

@@ -0,0 +1,12 @@
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from '../server.js';
+import { structuredLogger } from '../utils/structured-logger.js';
+export async function startStdioTransport(memoryStore) {
+    structuredLogger.success('KAIROS MCP Server starting', 'stdio transport');
+    structuredLogger.info('STDIO transport: enabled');
+    structuredLogger.info('STDOUT reserved for MCP protocol frames');
+    const server = createServer(memoryStore);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=stdio-server.js.map

package/dist/stdio/stdio-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-server.js","sourceRoot":"","sources":["../../src/stdio/stdio-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,WAA8B;IACtE,gBAAgB,CAAC,OAAO,CAAC,4BAA4B,EAAE,iBAAiB,CAAC,CAAC;IAC1E,gBAAgB,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAClD,gBAAgB,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IAEjE,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}

package/dist/tools/activate.d.ts

@@ -0,0 +1,11 @@
+import type { MemoryQdrantStore } from '../services/memory/store.js';
+import type { QdrantService } from '../services/qdrant/service.js';
+import { type ActivateInput, type ActivateOutput } from './activate_schema.js';
+interface RegisterActivateOptions {
+    toolName?: string;
+    qdrantService?: QdrantService;
+}
+export declare function executeActivate(memoryStore: MemoryQdrantStore, qdrantService: QdrantService | undefined, input: ActivateInput): Promise<ActivateOutput>;
+export declare function registerActivateTool(server: any, memoryStore: MemoryQdrantStore, options?: RegisterActivateOptions): void;
+export {};
+//# sourceMappingURL=activate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activate.d.ts","sourceRoot":"","sources":["../../src/tools/activate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAMnE,OAAO,EAA6C,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAgB1H,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAqLD,wBAAsB,eAAe,CACnC,WAAW,EAAE,iBAAiB,EAC9B,aAAa,EAAE,aAAa,GAAG,SAAS,EACxC,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,cAAc,CAAC,CAsBzB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,iBAAiB,EAAE,OAAO,GAAE,uBAA4B,QAiDtH"}

package/dist/tools/activate.js

@@ -0,0 +1,228 @@
+import crypto from 'node:crypto';
+import { resolveToolDoc } from '../utils/mcp-tool-doc-runtime.js';
+import { structuredLogger } from '../utils/structured-logger.js';
+import { mcpToolCalls, mcpToolDuration, mcpToolErrors, mcpToolInputSize, mcpToolOutputSize } from '../services/metrics/mcp-metrics.js';
+import { getTenantId, runWithOptionalSpaceAsync } from '../utils/tenant-context.js';
+import { executeSearch } from './search.js';
+import { activateInputSchema, activateOutputSchema } from './activate_schema.js';
+import { buildAdapterUri, parseKairosUri } from './kairos-uri.js';
+import { mcpLooseToolInput } from './mcp-loose-input-schema.js';
+import { mcpToolInputValidationErrorResult } from './mcp-tool-input-teaching.js';
+import { mcpRateLimitErrorResult } from './mcp-runtime-error.js';
+import { KAIROS_ACTIVATE_TOOL_UI_META } from '../mcp-apps/kairos-ui-constants.js';
+import { KAIROS_CREATION_FOOTER_NEXT_ACTION } from '../constants/builtin-search-meta.js';
+import { KAIROS_LOCAL_ARTIFACT_DIRS } from '../config.js';
+import { buildLocalArtifactDirFields } from './local-artifact-dir-contract.js';
+import { normalizeAuthorSlug } from '../utils/protocol-slug.js';
+import { listAdapterArtifacts } from './artifact-catalog.js';
+import { mintExportArtifactDownloadCapability } from '../services/export-artifact-download-capability.js';
+import { resolveExportAdapter } from './export-resolve-adapter.js';
+import { normalizeArtifactRelativePath } from './artifact-relative-path.js';
+import { activateRefinementStore } from '../services/activate-refinement-store.js';
+function canonicalizeAdapterUri(uri, options) {
+    if (options?.slug) {
+        return buildAdapterUri(options.slug);
+    }
+    const parsed = parseKairosUri(uri);
+    if (parsed.kind === 'adapter' && parsed.idKind === 'slug') {
+        return buildAdapterUri(parsed.id);
+    }
+    throw new Error(`Adapter URI must be slug-form at emit time: ${uri}`);
+}
+async function mapSearchToActivate(memoryStore, qdrantService, searchOutput, query, options) {
+    const escapeShellSingleQuoted = (value) => value.replace(/'/g, `'\\''`);
+    const escapeShellDoubleQuoted = (value) => value.replace(/["\\$`]/g, '\\$&');
+    const safeArtifactFileName = (value) => value.replace(/[/\\]/g, '_');
+    const defaultArtifactRelativePath = (fileName) => `artifacts/${safeArtifactFileName(fileName)}`;
+    const materializeCommand = (url, relativePath, sha256) => {
+        const relForPath = escapeShellDoubleQuoted(relativePath);
+        const relEscaped = escapeShellSingleQuoted(relativePath);
+        const shaEscaped = escapeShellSingleQuoted(sha256);
+        const urlEscaped = escapeShellSingleQuoted(url);
+        const parentDir = relativePath.includes('/') ? relativePath.slice(0, relativePath.lastIndexOf('/')) : '';
+        const parentDirForPath = escapeShellDoubleQuoted(parentDir);
+        const mkdirPart = parentDir.length > 0
+            ? `mkdir -p "$KAIROS_LOCAL_ARTIFACT_DIR/${parentDirForPath}" && `
+            : '';
+        return `${mkdirPart}curl -fsSL '${urlEscaped}' -o "$KAIROS_LOCAL_ARTIFACT_DIR/${relForPath}" && (cd "$KAIROS_LOCAL_ARTIFACT_DIR" && echo '${shaEscaped}  ${relEscaped}' | sha256sum -c) && chmod 700 "$KAIROS_LOCAL_ARTIFACT_DIR/${relForPath}"`;
+    };
+    const visibleChoices = options.includeRefineFooter
+        ? searchOutput.choices
+        : searchOutput.choices.filter((choice) => choice.role !== 'refine');
+    const choices = await Promise.all(visibleChoices.map(async (choice) => {
+        const adapterUri = canonicalizeAdapterUri(choice.uri, {
+            slug: choice.slug ?? normalizeAuthorSlug(choice.adapter_name ?? choice.label)
+        });
+        if (choice.role === 'create') {
+            return {
+                uri: adapterUri,
+                label: choice.label,
+                adapter_name: choice.adapter_name,
+                activation_score: choice.score,
+                role: choice.role,
+                tags: choice.tags,
+                next_action: choice.role === 'create'
+                    ? KAIROS_CREATION_FOOTER_NEXT_ACTION
+                    : `call forward with ${adapterUri} and no solution to start the refine adapter`,
+                adapter_version: choice.adapter_version,
+                activation_patterns: [],
+                space_name: choice.space_name ?? null,
+                slug: choice.slug ?? null,
+                forward_first_call: null
+            };
+        }
+        if (choice.role === 'refine') {
+            return {
+                uri: adapterUri,
+                label: choice.label,
+                adapter_name: choice.adapter_name,
+                activation_score: choice.score,
+                role: choice.role,
+                tags: choice.tags,
+                next_action: `call forward with ${adapterUri} and no solution to start the refine adapter`,
+                adapter_version: choice.adapter_version,
+                activation_patterns: [],
+                space_name: choice.space_name ?? null,
+                slug: choice.slug ?? null,
+                forward_first_call: {
+                    uri: adapterUri
+                }
+            };
+        }
+        const adapterLabel = choice.adapter_name ?? choice.label;
+        let linkedArtifacts = [];
+        try {
+            const { adapterId } = await resolveExportAdapter(memoryStore, qdrantService, adapterUri);
+            const linkedArtifactsRaw = await listAdapterArtifacts(memoryStore, adapterId);
+            linkedArtifacts = await Promise.all(linkedArtifactsRaw.map(async (artifact) => {
+                const normalizedRelativePath = artifact.relative_path && artifact.relative_path.trim().length > 0
+                    ? normalizeArtifactRelativePath(artifact.relative_path.trim())
+                    : null;
+                const relativePath = normalizedRelativePath ?? defaultArtifactRelativePath(artifact.name);
+                const capability = await mintExportArtifactDownloadCapability({
+                    artifactUuid: artifact.artifact_uuid,
+                    filename: artifact.name,
+                    contentType: artifact.content_type,
+                    sha256: artifact.sha256,
+                    relativePath
+                });
+                return {
+                    slug: artifact.slug,
+                    filename: artifact.name,
+                    relative_path: relativePath,
+                    download_url: capability.url,
+                    sha256: artifact.sha256,
+                    content_type: artifact.content_type,
+                    materialize: materializeCommand(capability.url, relativePath, artifact.sha256)
+                };
+            }));
+        }
+        catch (error) {
+            structuredLogger.warn(`[activate] failed to load linked artifacts for ${adapterUri}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        const nextAction = linkedArtifacts.length > 0
+            ? `Materialize this choice's linked_artifacts to $KAIROS_LOCAL_ARTIFACT_DIR, verify sha256, then call forward with ${adapterUri} and no solution to start this adapter`
+            : `call forward with ${adapterUri} and no solution to start this adapter`;
+        return {
+            uri: adapterUri,
+            label: adapterLabel,
+            adapter_name: adapterLabel,
+            activation_score: choice.score,
+            role: choice.role,
+            tags: choice.tags,
+            next_action: nextAction,
+            adapter_version: choice.adapter_version,
+            activation_patterns: choice.activation_patterns ?? [],
+            space_name: choice.space_name ?? null,
+            slug: choice.slug ?? null,
+            forward_first_call: {
+                uri: adapterUri
+            },
+            ...(linkedArtifacts.length > 0 ? { linked_artifacts: linkedArtifacts } : {})
+        };
+    }));
+    const groundingReminder = 'Protocols are interfaces for AI agents. Choose the adapter that serves the human\'s real need, follow it exactly, and never fabricate proof.';
+    const matchCount = choices.filter((c) => c.role === 'match').length;
+    const searchMessage = searchOutput.message;
+    const createOnlyMessage = (() => {
+        if (matchCount === 0) {
+            return 'No existing adapter/protocol matched your query. Create a new one or ask the user clarifying questions before searching again.';
+        }
+        if (matchCount === 1) {
+            return 'Found 1 match. You can run it or create a new adapter/protocol.';
+        }
+        const topMatch = choices.find((c) => c.role === 'match');
+        const confidencePercent = Math.round((topMatch?.activation_score ?? 0) * 100);
+        return `Found ${matchCount} matches (top confidence: ${confidencePercent}%). Choose one or create a new adapter/protocol.`;
+    })();
+    return {
+        must_obey: true,
+        message: `${groundingReminder}\n\n${options.includeRefineFooter ? searchMessage : createOnlyMessage}`,
+        next_action: "Pick one choice and follow that choice's next_action.",
+        execution_id: options.executionId,
+        query,
+        choices,
+        ...buildLocalArtifactDirFields(KAIROS_LOCAL_ARTIFACT_DIRS)
+    };
+}
+export async function executeActivate(memoryStore, qdrantService, input) {
+    const executionId = input.execution_id ?? crypto.randomUUID();
+    const refineCount = input.execution_id
+        ? await activateRefinementStore.incrementRefineCount(executionId)
+        : 0;
+    const includeRefineFooter = !input.execution_id || refineCount <= 2;
+    const searchOutput = await executeSearch(memoryStore, qdrantService, input, input.space ?? input.space_id
+        ? {
+            runInSpace: (fn) => runWithOptionalSpaceAsync(input.space ?? input.space_id ?? '', fn)
+        }
+        : undefined);
+    return mapSearchToActivate(memoryStore, qdrantService, searchOutput, input.query, {
+        executionId,
+        includeRefineFooter
+    });
+}
+export function registerActivateTool(server, memoryStore, options = {}) {
+    const toolName = options.toolName || 'activate';
+    const qdrantService = options.qdrantService;
+    structuredLogger.debug(`activate registration inputSchema: ${JSON.stringify(activateInputSchema)}`);
+    structuredLogger.debug(`activate registration outputSchema: ${JSON.stringify(activateOutputSchema)}`);
+    server.registerTool(toolName, {
+        title: 'Activate the best adapter',
+        description: resolveToolDoc('activate') || 'Find the best adapter for the current input and return ranked activation choices.',
+        inputSchema: mcpLooseToolInput(activateInputSchema),
+        outputSchema: activateOutputSchema,
+        _meta: KAIROS_ACTIVATE_TOOL_UI_META
+    }, async (params) => {
+        const tenantId = getTenantId();
+        mcpToolInputSize.observe({ tool: toolName, tenant_id: tenantId }, JSON.stringify(params).length);
+        const timer = mcpToolDuration.startTimer({ tool: toolName, tenant_id: tenantId });
+        const parsedInput = activateInputSchema.safeParse(params);
+        if (!parsedInput.success) {
+            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 mcpToolInputValidationErrorResult('activate', parsedInput.error, params);
+        }
+        const input = parsedInput.data;
+        try {
+            const output = await executeActivate(memoryStore, qdrantService, input);
+            mcpToolCalls.inc({ tool: toolName, status: 'success', tenant_id: tenantId });
+            mcpToolOutputSize.observe({ tool: toolName, tenant_id: tenantId }, JSON.stringify(output).length);
+            timer({ tool: toolName, status: 'success', tenant_id: tenantId });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(output) }],
+                structuredContent: 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 });
+            const rateLimitResult = mcpRateLimitErrorResult(error);
+            if (rateLimitResult)
+                return rateLimitResult;
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=activate.js.map

package/dist/tools/activate.js.map

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

package/dist/tools/activate_schema.d.ts

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+export declare const activateInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    execution_id: z.ZodOptional<z.ZodString>;
+    space: z.ZodOptional<z.ZodString>;
+    space_id: z.ZodOptional<z.ZodString>;
+    max_choices: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const activateOutputSchema: z.ZodObject<{
+    must_obey: z.ZodBoolean;
+    message: z.ZodString;
+    next_action: z.ZodString;
+    execution_id: z.ZodOptional<z.ZodString>;
+    query: z.ZodString;
+    choices: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        uri: z.ZodString;
+        label: z.ZodString;
+        adapter_name: z.ZodNullable<z.ZodString>;
+        activation_score: z.ZodNullable<z.ZodNumber>;
+        tags: z.ZodArray<z.ZodString>;
+        next_action: z.ZodString;
+        adapter_version: z.ZodNullable<z.ZodString>;
+        activation_patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        space_name: z.ZodNullable<z.ZodString>;
+        slug: z.ZodNullable<z.ZodString>;
+        role: z.ZodLiteral<"match">;
+        forward_first_call: z.ZodObject<{
+            uri: z.ZodString;
+        }, z.core.$strict>;
+        linked_artifacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            slug: z.ZodString;
+            filename: z.ZodString;
+            relative_path: z.ZodNullable<z.ZodString>;
+            download_url: z.ZodString;
+            sha256: z.ZodString;
+            content_type: z.ZodString;
+            materialize: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        uri: z.ZodString;
+        label: z.ZodString;
+        adapter_name: z.ZodNullable<z.ZodString>;
+        activation_score: z.ZodNullable<z.ZodNumber>;
+        tags: z.ZodArray<z.ZodString>;
+        next_action: z.ZodString;
+        adapter_version: z.ZodNullable<z.ZodString>;
+        activation_patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        space_name: z.ZodNullable<z.ZodString>;
+        slug: z.ZodNullable<z.ZodString>;
+        role: z.ZodLiteral<"refine">;
+        forward_first_call: z.ZodObject<{
+            uri: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strip>, z.ZodObject<{
+        uri: z.ZodString;
+        label: z.ZodString;
+        adapter_name: z.ZodNullable<z.ZodString>;
+        activation_score: z.ZodNullable<z.ZodNumber>;
+        tags: z.ZodArray<z.ZodString>;
+        next_action: z.ZodString;
+        adapter_version: z.ZodNullable<z.ZodString>;
+        activation_patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        space_name: z.ZodNullable<z.ZodString>;
+        slug: z.ZodNullable<z.ZodString>;
+        role: z.ZodLiteral<"create">;
+        forward_first_call: z.ZodNull;
+    }, z.core.$strip>], "role">>;
+    kairos_local_artifact_dir: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    squadrules_local_artifact_dir: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export type ActivateInput = z.infer<typeof activateInputSchema>;
+export type ActivateOutput = z.infer<typeof activateOutputSchema>;
+//# sourceMappingURL=activate_schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activate_schema.d.ts","sourceRoot":"","sources":["../../src/tools/activate_schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoExB,eAAO,MAAM,mBAAmB;;;;;;iBAmB9B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA4BtB,CAAC;AAEZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/tools/activate_schema.js

@@ -0,0 +1,102 @@
+import { z } from 'zod';
+import { KAIROS_SEARCH_LIMIT_CAP, KAIROS_SEARCH_LIMIT_MIN } from '../config.js';
+const adapterUriSchema = z
+    .string()
+    .regex(/^(?:kairos|squadrules):\/\/adapter\/([0-9a-f-]{36}|[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)$/i, 'must match kairos://adapter/{slug} (squadrules:// also accepted)');
+const adapterSlugUriSchema = z
+    .string()
+    .regex(/^(?:kairos|squadrules):\/\/adapter\/([0-9a-f-]{36}|[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)$/i, 'must match kairos://adapter/{slug} (squadrules:// also accepted)');
+const forwardFirstCallSchema = z
+    .object({
+    uri: adapterSlugUriSchema
+})
+    .strict();
+const executionIdSchema = z
+    .string()
+    .regex(/^[0-9a-f-]{36}$/i, 'must be a UUID');
+const linkedArtifactSchema = z
+    .object({
+    slug: z.string(),
+    filename: z.string(),
+    relative_path: z.string().nullable(),
+    download_url: z.string(),
+    sha256: z.string(),
+    content_type: z.string(),
+    materialize: z.string().describe('Shell command to download + verify this artifact into $KAIROS_LOCAL_ARTIFACT_DIR')
+})
+    .strict();
+const activateChoiceCommonSchema = z.object({
+    uri: adapterUriSchema,
+    label: z.string().describe('Display label for the adapter choice'),
+    adapter_name: z.string().nullable().describe('Adapter title when this choice maps to a stored adapter'),
+    activation_score: z.number().min(0).max(1).nullable().describe('Normalized 0.0-1.0 confidence for matches, null for refine/create'),
+    tags: z.array(z.string()),
+    next_action: z.string().describe('Instruction for this choice, typically a forward call'),
+    adapter_version: z.string().nullable().describe('Stored adapter version when present'),
+    activation_patterns: z.array(z.string()).optional().describe('Activation phrases associated with this adapter'),
+    space_name: z
+        .string()
+        .nullable()
+        .describe('Human-readable space where the adapter is stored; null for refine/create choices'),
+    slug: z
+        .string()
+        .nullable()
+        .describe('Adapter routing slug when stored (use with kairos://adapter/{slug} in forward); null for refine/create or when absent')
+});
+const activateMatchChoiceSchema = activateChoiceCommonSchema.extend({
+    role: z.literal('match'),
+    forward_first_call: forwardFirstCallSchema,
+    linked_artifacts: z.array(linkedArtifactSchema).optional()
+});
+const activateRefineChoiceSchema = activateChoiceCommonSchema.extend({
+    role: z.literal('refine'),
+    forward_first_call: forwardFirstCallSchema
+});
+const activateCreateChoiceSchema = activateChoiceCommonSchema.extend({
+    role: z.literal('create'),
+    forward_first_call: z.null()
+});
+export const activateInputSchema = z.object({
+    query: z.string().min(1).describe('Activation query used to find the best matching adapter'),
+    execution_id: executionIdSchema
+        .optional()
+        .describe('Server-issued execution id for a refinement sequence. Echo this back when re-running activate to refine the query for the same user request.'),
+    space: z
+        .string()
+        .optional()
+        .describe('Scope results to this space: "personal", a group name, "Group: …", or your space id'),
+    space_id: z.string().optional().describe('Alias for space'),
+    max_choices: z
+        .number()
+        .int()
+        .min(KAIROS_SEARCH_LIMIT_MIN)
+        .max(KAIROS_SEARCH_LIMIT_CAP)
+        .optional()
+        .describe('Maximum adapter choices to return')
+});
+export const activateOutputSchema = z.object({
+    must_obey: z.boolean().describe('Always true. Pick one adapter and follow next_action.'),
+    message: z.string(),
+    next_action: z.string().describe("Global directive: pick one choice and follow that choice's next_action."),
+    execution_id: executionIdSchema
+        .optional()
+        .describe('Server-issued execution id for this activation run. Echo this id back when re-running activate with a refined query.'),
+    /** Echo of the request query for MCP App / HTTP clients (human-facing headers). */
+    query: z.string().describe('Same string as the activate input query.'),
+    choices: z.array(z.discriminatedUnion('role', [
+        activateMatchChoiceSchema,
+        activateRefineChoiceSchema,
+        activateCreateChoiceSchema
+    ])),
+    /**
+     * Ordered URI hints (preferred first) for the run's local handoff dir. Resolve **on the client**:
+     * `project://<rel>` → `<client project root>/<rel>`; `user://<rel>` → `<client home or $XDG_CONFIG_HOME>/<rel>`.
+     * Use `project://` when you have exactly one project context; fall through to `user://` when your session
+     * spans multiple projects. Export the resolved absolute path as `KAIROS_LOCAL_ARTIFACT_DIR` for shell
+     * challenges. The server never resolves these to a path on its own filesystem.
+     */
+    kairos_local_artifact_dir: z.array(z.string()).optional(),
+    /** Compatibility alias for kairos_local_artifact_dir (same value). */
+    squadrules_local_artifact_dir: z.array(z.string()).optional()
+}).strict();
+//# sourceMappingURL=activate_schema.js.map