@beingmartinbmc/ojas 0.2.0

package/dist/mcp/tools/recovery.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerRecoveryTools = registerRecoveryTools;
+const v3_1 = require("zod/v3");
+const envelope_1 = require("../envelope");
+const id_1 = require("../../util/id");
+const shared_1 = require("./shared");
+function registerRecoveryTools(registerOjasTool, registry, _audit) {
+    // ── 11. ojas_diagnose_failure ────────────────────────────────────────────
+    registerOjasTool('ojas_diagnose_failure', {
+        title: 'Diagnose why an agent failed or degraded',
+        description: 'Chikitsa classifies an agent failure (bad context, weak planning, tool failure, retrieval error, ' +
+            'prompt injection, instruction conflict, model limitation, unclear objective, excessive cognitive load) ' +
+            'and emits a structured repair plan.',
+        inputSchema: {
+            agent_id: v3_1.z.string().min(1),
+            session_id: v3_1.z.string().optional(),
+            failure_description: v3_1.z.string().min(1),
+            failure_type: v3_1.z.enum(shared_1.FAILURE_TYPES).optional(),
+            severity: v3_1.z.enum(['low', 'medium', 'high', 'critical']).default('medium'),
+            include_trace: v3_1.z.boolean().default(true),
+            include_memory_events: v3_1.z.boolean().default(true),
+            include_tool_events: v3_1.z.boolean().default(true),
+        },
+    }, async ({ agent_id, failure_description, failure_type, severity, session_id, include_trace, include_memory_events, include_tool_events, }) => {
+        const entry = registry.getOrAutoRegisterSession(agent_id, session_id);
+        const inferredType = failure_type ?? (0, shared_1.inferFailureType)(failure_description);
+        const failure = {
+            type: inferredType,
+            message: failure_description,
+            severity,
+        };
+        const [protocol] = entry.ojas.chikitsa.diagnose([failure]);
+        const secondaryCauses = [];
+        const report = entry.ojas.healthCheck();
+        if (report.metabolism.costPressure > 0.7)
+            secondaryCauses.push('high_cost_pressure');
+        if (report.recovery.driftScore > 0.5)
+            secondaryCauses.push('cognitive_drift');
+        if (report.defense.quarantinedItems > 0)
+            secondaryCauses.push('contaminated_inputs');
+        if (report.resilience.weaknesses.length > 0)
+            secondaryCauses.push('known_resilience_weakness');
+        void include_trace;
+        void include_memory_events;
+        void include_tool_events;
+        return (0, envelope_1.mcpReply)({
+            diagnosis_id: protocol.id,
+            primary_cause: inferredType,
+            diagnosis: protocol.diagnosis,
+            secondary_causes: secondaryCauses,
+            severity: protocol.severity,
+            recommended_repair: protocol.actions,
+            ...(0, envelope_1.sessionScopeFields)(session_id),
+        }, {
+            agent_id,
+            status: protocol.severity === 'critical' ? 'warning' : 'success',
+            affected_modules: ['chikitsa', 'pulse'],
+            recommended_next_actions: protocol.actions,
+            requires_human_review: protocol.severity === 'critical',
+        });
+    });
+    // ── 12. ojas_run_recovery ────────────────────────────────────────────────
+    registerOjasTool('ojas_run_recovery', {
+        title: 'Run a recovery protocol (observe / recommend / apply)',
+        description: 'Run a recovery protocol for a degraded agent. Modes: "observe" (no-op telemetry only), ' +
+            '"recommend" (return the action plan without executing — DEFAULT), or "apply" (execute the safe ' +
+            'subset of actions: enter_safe_mode, freeze_memory_writes, etc.).',
+        inputSchema: {
+            agent_id: v3_1.z.string().min(1),
+            session_id: v3_1.z.string().optional(),
+            recovery_type: v3_1.z
+                .enum([
+                'tool_failure_loop',
+                'context_overload',
+                'prompt_injection',
+                'memory_conflict',
+                'hallucination',
+                'high_cost_pressure',
+                'unknown',
+            ])
+                .default('unknown'),
+            mode: v3_1.z.enum(shared_1.TOOL_MODES).default('recommend'),
+            allowed_actions: v3_1.z.array(v3_1.z.enum(shared_1.RECOVERY_ACTIONS)).optional(),
+        },
+    }, async ({ agent_id, session_id, recovery_type, mode, allowed_actions }) => {
+        const entry = registry.getOrAutoRegisterSession(agent_id, session_id);
+        // Snapshot health before applying so we can report a measured delta.
+        const before = Math.round(entry.ojas.healthCheck().overall.value * 100);
+        const plan = (0, shared_1.actionsForRecoveryType)(recovery_type, allowed_actions);
+        const mutatedActions = [];
+        const instructionActions = [];
+        const skippedActions = [];
+        if (mode === 'apply') {
+            for (const step of plan) {
+                switch (step.action) {
+                    case 'enter_safe_mode':
+                        registry.setSafeMode(entry, true, recovery_type, plan.map((s) => s.action));
+                        mutatedActions.push(step.action);
+                        break;
+                    case 'freeze_memory_writes':
+                    case 'quarantine_input':
+                    case 'reset_plan':
+                    case 'compress_context':
+                    case 'generate_fallback_response':
+                    case 'reduce_tool_calls':
+                    case 'switch_to_cached_sources':
+                        // These are instructions for the calling agent. Ojas cannot
+                        // mutate external tools, contexts, or memory stores by itself.
+                        instructionActions.push(step.action);
+                        break;
+                    case 'human_escalation':
+                        // Don't auto-apply human_escalation — flag for review instead.
+                        skippedActions.push(step.action);
+                        break;
+                }
+            }
+        }
+        // Measured score delta. In recommend / observe modes nothing was
+        // applied, so delta stays 0. In apply mode we re-run healthCheck.
+        let measuredDelta = 0;
+        if (mode === 'apply') {
+            const afterReport = entry.ojas.healthCheck();
+            const after = Math.round(afterReport.overall.value * 100);
+            measuredDelta = after - before;
+            registry.updateHealthSnapshot(entry, afterReport);
+        }
+        const outcome = mode !== 'apply'
+            ? 'recommended'
+            : mutatedActions.length > 0
+                ? 'applied'
+                : instructionActions.length > 0
+                    ? 'instructed'
+                    : skippedActions.length > 0
+                        ? 'requires_human_review'
+                        : 'no_effect';
+        const event = registry.recordEvent(entry, 'recovery_protocol_generated', recovery_type);
+        return (0, envelope_1.mcpReply)({
+            recovery_id: (0, id_1.newId)('recovery'),
+            recovery_type,
+            mode,
+            outcome,
+            actions: plan,
+            mutated_actions: mutatedActions,
+            instruction_actions: instructionActions,
+            skipped_actions: skippedActions,
+            // Deprecated compatibility alias: durable mutations only.
+            applied_actions: mutatedActions,
+            // Reports the actual pre/post scores from `apply` mode (both equal in
+            // `recommend` / `observe` since nothing was applied). No more
+            // hardcoded "+9" predictions.
+            ojas_score_before: before,
+            ojas_score_after: mode === 'apply' ? before + measuredDelta : before,
+            safe_mode: entry.safe_mode,
+            ...(0, envelope_1.sessionScopeFields)(session_id),
+        }, {
+            agent_id,
+            affected_modules: ['chikitsa', 'pulse'],
+            events_created: [event.id],
+            ojas_score_delta: measuredDelta,
+            requires_human_review: plan.some((p) => p.action === 'human_escalation'),
+        });
+    });
+}
+//# sourceMappingURL=recovery.js.map

package/dist/mcp/tools/recovery.js.map

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

package/dist/mcp/tools/registrar.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export type OjasToolRegistrar = McpServer['registerTool'];
+export declare function createOjasToolRegistrar(server: McpServer): OjasToolRegistrar;
+//# sourceMappingURL=registrar.d.ts.map

package/dist/mcp/tools/registrar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registrar.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/registrar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,MAAM,MAAM,iBAAiB,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;AAE1D,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,iBAAiB,CAW5E"}

package/dist/mcp/tools/registrar.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOjasToolRegistrar = createOjasToolRegistrar;
+const envelope_1 = require("../envelope");
+function createOjasToolRegistrar(server) {
+    return ((...regArgs) => {
+        const handler = regArgs[regArgs.length - 1];
+        if (typeof handler === 'function') {
+            const name = String(regArgs[0]);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            regArgs[regArgs.length - 1] = (0, envelope_1.safeHandler)(name, handler);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return server.registerTool(...regArgs);
+    });
+}
+//# sourceMappingURL=registrar.js.map

package/dist/mcp/tools/registrar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registrar.js","sourceRoot":"","sources":["../../../src/mcp/tools/registrar.ts"],"names":[],"mappings":";;AAMA,0DAWC;AAfD,0CAA0C;AAI1C,SAAgB,uBAAuB,CAAC,MAAiB;IACvD,OAAO,CAAC,CAAC,GAAG,OAAkB,EAAE,EAAE;QAChC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC5C,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;YAChC,8DAA8D;YAC9D,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,IAAA,sBAAW,EAAC,IAAI,EAAE,OAAc,CAAC,CAAC;QAClE,CAAC;QACD,8DAA8D;QAC9D,OAAQ,MAAM,CAAC,YAAoB,CAAC,GAAG,OAAO,CAAC,CAAC;IAClD,CAAC,CAAsB,CAAC;AAC1B,CAAC"}

package/dist/mcp/tools/report.d.ts

@@ -0,0 +1,4 @@
+import type { AgentRegistry } from '../registry';
+import type { OjasToolRegistrar } from './registrar';
+export declare function registerReportTools(registerOjasTool: OjasToolRegistrar, registry: AgentRegistry, _audit?: import('../audit').AuditLogger): void;
+//# sourceMappingURL=report.d.ts.map

package/dist/mcp/tools/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/report.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAOrD,wBAAgB,mBAAmB,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,OAAO,UAAU,EAAE,WAAW,GAAG,IAAI,CAoE/I"}

package/dist/mcp/tools/report.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerReportTools = registerReportTools;
+const v3_1 = require("zod/v3");
+const contracts_1 = require("../contracts");
+const envelope_1 = require("../envelope");
+const id_1 = require("../../util/id");
+const shared_1 = require("./shared");
+function registerReportTools(registerOjasTool, registry, _audit) {
+    // ── 18. ojas_generate_health_report ──────────────────────────────────────
+    registerOjasTool('ojas_generate_health_report', {
+        title: 'Generate an Ojas health report for a session or agent',
+        description: 'Produce a structured health report for an agent — overall Ojas score, narrative summary, ' +
+            'top operational risks, and concrete recommended next steps. Suitable for dashboards, ' +
+            'release gates, and human review.',
+        inputSchema: {
+            agent_id: v3_1.z.string().min(1),
+            session_id: v3_1.z.string().optional(),
+            scope: v3_1.z.enum(['current', 'session', 'last_24h']).default('current'),
+            report_type: v3_1.z.enum(['executive_summary', 'technical']).default('executive_summary'),
+            include_recommendations: v3_1.z.boolean().default(true),
+        },
+    }, async ({ agent_id, session_id, scope, report_type, include_recommendations }) => {
+        const entry = registry.getOrAutoRegisterSession(agent_id, session_id);
+        // Read-only tool: no snapshot mutation.
+        const report = entry.ojas.healthCheck();
+        const delta = 0;
+        const ojasScore = Math.round(report.overall.value * 100);
+        const healthState = (0, contracts_1.classifyHealthState)(ojasScore, entry.contract);
+        const topRisks = (0, shared_1.pickTopModulesBelow)(80, report.moduleScores).map((m) => `${m}_below_target`);
+        if (report.metabolism.costPressure > 0.8)
+            topRisks.push('over_retrieval');
+        if (report.recovery.driftScore > 0.5)
+            topRisks.push('cognitive_drift');
+        if (report.defense.quarantinedItems > 0)
+            topRisks.push('contaminated_inputs');
+        const nextSteps = include_recommendations
+            ? report.recommendations
+                .filter((r) => r.severity !== 'info' && r.action)
+                .map((r) => r.action)
+                .slice(0, 6)
+            : [];
+        const summary = healthState === 'healthy'
+            ? `${entry.contract.agent_name ?? entry.agent_id} is healthy (Ojas ${ojasScore}/100). No critical issues.`
+            : healthState === 'watch'
+                ? `${entry.contract.agent_name ?? entry.agent_id} is operational at Ojas ${ojasScore}/100 with mild degradation under load.`
+                : `${entry.contract.agent_name ?? entry.agent_id} health is ${healthState} (Ojas ${ojasScore}/100). Recovery recommended before continued autonomous operation.`;
+        void scope;
+        return (0, envelope_1.mcpReply)({
+            report_id: (0, id_1.newId)('report'),
+            report_type,
+            overall_ojas_score: ojasScore,
+            health_state: healthState,
+            module_scores: report.moduleScores,
+            summary,
+            top_risks: [...new Set(topRisks)].slice(0, 6),
+            recommended_next_steps: nextSteps,
+            ...(0, envelope_1.sessionScopeFields)(session_id),
+        }, {
+            agent_id,
+            ojas_score_delta: delta,
+            affected_modules: ['pulse'],
+            recommended_next_actions: nextSteps,
+            requires_human_review: healthState === 'degraded' || healthState === 'critical',
+        });
+    });
+}
+//# sourceMappingURL=report.js.map

package/dist/mcp/tools/report.js.map

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

package/dist/mcp/tools/shared.d.ts

@@ -0,0 +1,37 @@
+import type { OjasModuleName, RuntimeFailureType } from '../../types';
+import type { AgentRiskLevel, RecoveryActionId, ToolMode } from '../contracts';
+import type { TraceEventType } from '../trace';
+export declare const nowSec: () => number;
+export declare const estimateTokens: (s: string) => number;
+export type RelevanceSource = 'caller' | 'lexical_fallback';
+export declare function resolveRelevance(supplied: number | undefined, task: string, content: string): {
+    score: number;
+    source: RelevanceSource;
+};
+/**
+ * Parse an optional ISO-8601 timestamp string from MCP input and return its
+ * epoch-seconds value. Returns `null` on invalid input so the caller can
+ * reject the request rather than silently producing NaN.
+ */
+export declare function parseCreatedAt(input: string | undefined): {
+    ok: true;
+    epochSec: number;
+} | {
+    ok: false;
+    reason: string;
+} | {
+    ok: 'absent';
+};
+export declare const RISK_LEVELS: [AgentRiskLevel, ...AgentRiskLevel[]];
+export declare const TOOL_MODES: [ToolMode, ...ToolMode[]];
+export declare const DISTILLER_INTENSITIES: readonly ["lite", "full", "ultra"];
+export declare const TRACE_EVENT_TYPES: [TraceEventType, ...TraceEventType[]];
+export declare const FAILURE_TYPES: [RuntimeFailureType, ...RuntimeFailureType[]];
+export declare const RECOVERY_ACTIONS: [RecoveryActionId, ...RecoveryActionId[]];
+export declare function pickTopModulesBelow(threshold: number, scores: object): OjasModuleName[];
+export declare function inferFailureType(description: string): RuntimeFailureType;
+export declare function actionsForRecoveryType(recoveryType: string, allowed?: RecoveryActionId[]): {
+    action: RecoveryActionId;
+    reason: string;
+}[];
+//# sourceMappingURL=shared.d.ts.map

package/dist/mcp/tools/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,eAAO,MAAM,MAAM,QAAO,MAA2B,CAAC;AACtD,eAAO,MAAM,cAAc,GAAI,GAAG,MAAM,KAAG,MAA8C,CAAC;AA+C1F,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,kBAAkB,CAAC;AAE5D,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAK5C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,QAAQ,CAAA;CAAE,CAY3I;AAED,eAAO,MAAM,WAAW,EAAE,CAAC,cAAc,EAAE,GAAG,cAAc,EAAE,CAAyC,CAAC;AACxG,eAAO,MAAM,UAAU,EAAE,CAAC,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAAqC,CAAC;AACvF,eAAO,MAAM,qBAAqB,oCAAqC,CAAC;AACxE,eAAO,MAAM,iBAAiB,EAAE,CAAC,cAAc,EAAE,GAAG,cAAc,EAAE,CAkBnE,CAAC;AACF,eAAO,MAAM,aAAa,EAAE,CAAC,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,CASvE,CAAC;AACF,eAAO,MAAM,gBAAgB,EAAE,CAAC,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAUtE,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CAOvF;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,CAUxE;AAED,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,gBAAgB,EAAE,GAC3B;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,CAuDhD"}

package/dist/mcp/tools/shared.js

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RECOVERY_ACTIONS = exports.FAILURE_TYPES = exports.TRACE_EVENT_TYPES = exports.DISTILLER_INTENSITIES = exports.TOOL_MODES = exports.RISK_LEVELS = exports.estimateTokens = exports.nowSec = void 0;
+exports.resolveRelevance = resolveRelevance;
+exports.parseCreatedAt = parseCreatedAt;
+exports.pickTopModulesBelow = pickTopModulesBelow;
+exports.inferFailureType = inferFailureType;
+exports.actionsForRecoveryType = actionsForRecoveryType;
+const nowSec = () => Date.now() / 1000;
+exports.nowSec = nowSec;
+const estimateTokens = (s) => Math.max(1, Math.ceil(s.length / 4));
+exports.estimateTokens = estimateTokens;
+/**
+ * Lexical task-to-content relevance fallback. When a caller does not supply
+ * `relevance_score`, we compute Jaccard token overlap between the task and
+ * the item content. This is a baseline heuristic only — no semantics, no
+ * embeddings — and is gameable by keyword stuffing. Callers that can provide
+ * embedding-based or model-judged scores should pass `relevance_score`.
+ */
+const STOPWORDS = new Set([
+    'the', 'and', 'for', 'are', 'but', 'not', 'you', 'all', 'any', 'can',
+    'her', 'was', 'one', 'our', 'out', 'day', 'has', 'how', 'man', 'new',
+    'now', 'old', 'see', 'two', 'way', 'who', 'its', 'with', 'this', 'that',
+    'from', 'have', 'will', 'they', 'them', 'their', 'what', 'when', 'were',
+    'would', 'about', 'which', 'into', 'over', 'than', 'then', 'these',
+    'those', 'some', 'such', 'your', 'just', 'also',
+]);
+function tokenize(text) {
+    const tokens = new Set();
+    const words = text.toLowerCase().replace(/[^a-z0-9\s]/g, ' ').split(/\s+/);
+    for (const w of words) {
+        if (w.length >= 3 && !STOPWORDS.has(w))
+            tokens.add(w);
+    }
+    return tokens;
+}
+/**
+ * Lexical task-to-content relevance in [0, 1]. Uses Jaccard overlap of
+ * non-stopword tokens with a small floor (0.05) so completely-different
+ * content has a near-zero but defined score. Returns 0.5 when the task is
+ * unparseable (no meaningful tokens) so missing tasks don't bias scoring.
+ */
+function lexicalRelevance(task, content) {
+    const taskTokens = tokenize(task);
+    const contentTokens = tokenize(content);
+    if (taskTokens.size === 0)
+        return 0.5;
+    if (contentTokens.size === 0)
+        return 0.1;
+    let intersection = 0;
+    for (const t of taskTokens)
+        if (contentTokens.has(t))
+            intersection += 1;
+    const union = taskTokens.size + contentTokens.size - intersection;
+    if (union === 0)
+        return 0.5;
+    const jaccard = intersection / union;
+    // Map raw Jaccard (typically 0..0.4 even for relevant docs) to a usable
+    // 0..1 score: 0 → 0.05, 0.05 → ~0.3, 0.15 → ~0.6, 0.3+ → 0.85+.
+    return Math.min(1, 0.05 + jaccard * 2.7);
+}
+function resolveRelevance(supplied, task, content) {
+    if (typeof supplied === 'number' && Number.isFinite(supplied) && supplied >= 0 && supplied <= 1) {
+        return { score: supplied, source: 'caller' };
+    }
+    return { score: lexicalRelevance(task, content), source: 'lexical_fallback' };
+}
+/**
+ * Parse an optional ISO-8601 timestamp string from MCP input and return its
+ * epoch-seconds value. Returns `null` on invalid input so the caller can
+ * reject the request rather than silently producing NaN.
+ */
+function parseCreatedAt(input) {
+    if (input === undefined)
+        return { ok: 'absent' };
+    // Require an explicit ISO-8601 timestamp instead of relying on
+    // implementation-dependent Date.parse forms like "1/2/2020".
+    const isoLike = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/;
+    if (!isoLike.test(input))
+        return { ok: false, reason: `created_at must be ISO-8601: ${input}` };
+    const parsed = new Date(input).getTime();
+    if (!Number.isFinite(parsed))
+        return { ok: false, reason: `Invalid created_at: ${input}` };
+    if (parsed > Date.now() + 60_000) {
+        return { ok: false, reason: `created_at is in the future: ${input}` };
+    }
+    return { ok: true, epochSec: parsed / 1000 };
+}
+exports.RISK_LEVELS = ['low', 'medium', 'high', 'critical'];
+exports.TOOL_MODES = ['observe', 'recommend', 'apply'];
+exports.DISTILLER_INTENSITIES = ['lite', 'full', 'ultra'];
+exports.TRACE_EVENT_TYPES = [
+    'agent_input',
+    'agent_output',
+    'tool_call_started',
+    'tool_call_succeeded',
+    'tool_call_failed',
+    'retrieval_result',
+    'memory_read',
+    'memory_write',
+    'failure',
+    'latency_measurement',
+    'token_usage',
+    'user_correction',
+    'planning_loop',
+    'fallback',
+    'policy_violation',
+    'prompt_injection_detected',
+    'context_overload_detected',
+];
+exports.FAILURE_TYPES = [
+    'tool_error',
+    'timeout',
+    'hallucination',
+    'policy_violation',
+    'retrieval_noise',
+    'loop',
+    'prompt_injection',
+    'unknown',
+];
+exports.RECOVERY_ACTIONS = [
+    'compress_context',
+    'reset_plan',
+    'freeze_memory_writes',
+    'quarantine_input',
+    'generate_fallback_response',
+    'enter_safe_mode',
+    'human_escalation',
+    'reduce_tool_calls',
+    'switch_to_cached_sources',
+];
+function pickTopModulesBelow(threshold, scores) {
+    const entries = Object.entries(scores);
+    return entries
+        .filter(([, v]) => v < threshold)
+        .sort((a, b) => a[1] - b[1])
+        .slice(0, 3)
+        .map(([k]) => k);
+}
+function inferFailureType(description) {
+    const d = description.toLowerCase();
+    if (/(loop|repeated|stuck)/.test(d))
+        return 'loop';
+    if (/(inject|ignore previous|system prompt)/.test(d))
+        return 'prompt_injection';
+    if (/(timeout|timed out)/.test(d))
+        return 'timeout';
+    if (/(hallucin|fabricat|cited.*non[- ]existent)/.test(d))
+        return 'hallucination';
+    if (/(policy|safety|unsafe)/.test(d))
+        return 'policy_violation';
+    if (/(retrieval|noisy context|irrelevant)/.test(d))
+        return 'retrieval_noise';
+    if (/(tool|api .*error|503|500)/.test(d))
+        return 'tool_error';
+    return 'unknown';
+}
+function actionsForRecoveryType(recoveryType, allowed) {
+    let recipe;
+    switch (recoveryType) {
+        case 'tool_failure_loop':
+            recipe = [
+                { action: 'freeze_memory_writes', reason: 'avoid storing degraded loop behavior' },
+                { action: 'reset_plan', reason: 'agent is stuck in repeated tool-call loop' },
+                { action: 'generate_fallback_response', reason: 'underlying tool unavailable after repeated attempts' },
+            ];
+            break;
+        case 'context_overload':
+            recipe = [
+                { action: 'compress_context', reason: 'active context exceeds healthy budget' },
+                { action: 'reduce_tool_calls', reason: 'prevent further intake until context settles' },
+            ];
+            break;
+        case 'prompt_injection':
+            recipe = [
+                { action: 'quarantine_input', reason: 'hostile instruction content detected' },
+                { action: 'freeze_memory_writes', reason: 'prevent contamination of long-term memory' },
+                { action: 'human_escalation', reason: 'verify safety boundary before resuming' },
+            ];
+            break;
+        case 'memory_conflict':
+            recipe = [
+                { action: 'freeze_memory_writes', reason: 'memory store is internally inconsistent' },
+                { action: 'reset_plan', reason: 'replan with verified facts only' },
+            ];
+            break;
+        case 'hallucination':
+            recipe = [
+                { action: 'reset_plan', reason: 'reground from authoritative sources' },
+                { action: 'switch_to_cached_sources', reason: 'avoid speculative generation under uncertainty' },
+            ];
+            break;
+        case 'high_cost_pressure':
+            recipe = [
+                { action: 'compress_context', reason: 'token / latency budget is critical' },
+                { action: 'reduce_tool_calls', reason: 'cap fan-out to stay within budget' },
+            ];
+            break;
+        default:
+            recipe = [
+                { action: 'enter_safe_mode', reason: 'fallback recovery for unclassified degradation' },
+                { action: 'human_escalation', reason: 'escalate for operator review' },
+            ];
+    }
+    if (allowed && allowed.length > 0) {
+        const set = new Set(allowed);
+        recipe = recipe.filter((step) => set.has(step.action));
+        if (recipe.length === 0) {
+            recipe = allowed.map((a) => ({ action: a, reason: 'allowed-list fallback' }));
+        }
+    }
+    return recipe;
+}
+//# sourceMappingURL=shared.js.map

package/dist/mcp/tools/shared.js.map

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

package/dist/mcp/trace.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Rich trace event taxonomy for the Ojas MCP `ojas_ingest_trace` tool.
+ *
+ * The on-disk Ojas runtime uses a single `ExecutionTrace` shape, but the
+ * MCP boundary accepts a richer event vocabulary so that agents can stream
+ * tool calls, retrievals, memory ops, fallbacks, and policy violations
+ * without flattening everything into a single action label.
+ */
+import type { OjasModuleName } from '../types';
+export type TraceEventType = 'agent_input' | 'agent_output' | 'tool_call_started' | 'tool_call_succeeded' | 'tool_call_failed' | 'retrieval_result' | 'memory_read' | 'memory_write' | 'failure' | 'latency_measurement' | 'token_usage' | 'user_correction' | 'planning_loop' | 'fallback' | 'policy_violation' | 'prompt_injection_detected' | 'context_overload_detected';
+export interface IngestedTraceMeta {
+    /** Logical action name to record in the Ojas trace store. */
+    action: string;
+    /** Whether the event indicates a successful step (true by default). */
+    success: boolean;
+    /** Duration of the step in ms; 0 if not measured. */
+    duration_ms: number;
+    /** Optional error string when success=false. */
+    error?: string;
+    /** Optional reasoning summary captured at the time of the event. */
+    reasoning?: string;
+    /** Total tokens consumed in this step, parsed from `data` when reported. */
+    tokens_used?: number;
+    /** Input/prompt tokens reported by the caller. */
+    input_tokens?: number;
+    /** Output/completion tokens reported by the caller. */
+    output_tokens?: number;
+    /** Number of tool calls invoked. */
+    tool_calls?: number;
+    /** Reported cost in USD if a model gateway provided it. */
+    cost_usd?: number;
+}
+/**
+ * Map a `TraceEventType` + arbitrary payload to the canonical Ojas
+ * `ExecutionTrace` shape plus a set of modules whose state is touched.
+ */
+export declare function classifyEvent(eventType: TraceEventType, data?: Record<string, unknown>): {
+    meta: IngestedTraceMeta;
+    affected_modules: OjasModuleName[];
+    health_impact: boolean;
+};
+/**
+ * Recommend a follow-up Ojas action keyed off the event type. Returned
+ * verbatim in `ojas_ingest_trace`'s response.
+ */
+export declare function recommendActionFor(eventType: TraceEventType): string | undefined;
+//# sourceMappingURL=trace.d.ts.map

package/dist/mcp/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/mcp/trace.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,cAAc,GACd,mBAAmB,GACnB,qBAAqB,GACrB,kBAAkB,GAClB,kBAAkB,GAClB,aAAa,GACb,cAAc,GACd,SAAS,GACT,qBAAqB,GACrB,aAAa,GACb,iBAAiB,GACjB,eAAe,GACf,UAAU,GACV,kBAAkB,GAClB,2BAA2B,GAC3B,2BAA2B,CAAC;AAEhC,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA8BD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,cAAc,EACzB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,gBAAgB,EAAE,cAAc,EAAE,CAAC;IAAC,aAAa,EAAE,OAAO,CAAA;CAAE,CAuKzF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAkBhF"}