@alan512/experienceengine 0.4.0 → 0.4.1

package/dist/adapters/shared-mcp/behavior-loop.js

@@ -0,0 +1,218 @@
+import { loadConfig } from "../../config/load-config.js";
+import { resolveExperienceEnginePaths } from "../../config/path-resolver.js";
+import { buildRetrievalPolicyInspectionSummary } from "../../interaction/retrieval-policy-inspection.js";
+import { ExperiencePromptRuntimeService } from "../../runtime/prompt-service.js";
+const createSharedConfig = (adapter, options = {}) => {
+    const paths = resolveExperienceEnginePaths({
+        adapter,
+        env: options.env ?? process.env,
+        homeDir: options.homeDir
+    });
+    return loadConfig({
+        dataDir: paths.dataDir,
+        sqlitePath: paths.sqlitePath,
+        captureDir: paths.captureDir
+    }, {
+        env: options.env ?? process.env,
+        homeDir: options.homeDir
+    });
+};
+const createSharedPromptRuntime = (adapter, options = {}) => new ExperiencePromptRuntimeService(createSharedConfig(adapter, options));
+const createSharedRuntime = async (adapter, options = {}) => {
+    const { ExperienceRuntimeService } = await import("../../runtime/service.js");
+    return new ExperienceRuntimeService(createSharedConfig(adapter, options), undefined, {
+        ...options.runtimeOptions,
+        autonomousHygieneGovernance: {
+            enabled: true,
+            ...options.runtimeOptions?.autonomousHygieneGovernance
+        }
+    });
+};
+const summarizeActionReason = (scorecard) => {
+    if (scorecard.mode === "inject_conservative") {
+        if (scorecard.decisionReason === "ambiguous_same_family_candidate") {
+            return "ExperienceEngine found a promising same-family match and chose conservative injection instead of skipping.";
+        }
+        if (scorecard.decisionReason === "promising_candidate_quality") {
+            return "ExperienceEngine found a credible candidate, but kept the injection conservative until it has stronger runtime proof.";
+        }
+        return "ExperienceEngine chose conservative injection because the best match still needs more runtime evidence.";
+    }
+    if (scorecard.decisionReason === "mature_validated_candidate") {
+        return "A mature validated candidate cleared the fast path, so ExperienceEngine injected it normally.";
+    }
+    if (scorecard.decisionReason === "candidate_quality_positive") {
+        return "Candidate quality was strong enough to justify intervention for this task.";
+    }
+    if (scorecard.mode === "inject") {
+        return "ExperienceEngine injected the best available reusable guidance for this task.";
+    }
+    return undefined;
+};
+const summarizeTrust = (scorecard) => {
+    const primaryNode = scorecard.nodes?.[0];
+    if (!scorecard.riskLevel || !primaryNode?.state) {
+        return undefined;
+    }
+    const confidence = scorecard.confidence ? ` ${scorecard.confidence}-confidence` : "";
+    return `${scorecard.riskLevel}-risk${confidence} ${primaryNode.state} guidance with ${primaryNode.helped ?? 0} helped and ${primaryNode.harmed ?? 0} harmed signal(s).`;
+};
+const summarizeRetrievalNotes = (scorecard) => {
+    const notes = [];
+    if (scorecard.queryRewriteApplied) {
+        notes.push("Query rewrite preserved retrieval intent for this task.");
+    }
+    const rerankSource = scorecard.topCandidates?.[0]?.rerankSource;
+    if (rerankSource === "model") {
+        notes.push("Model reranking participated in the final ordering.");
+    }
+    if (scorecard.fastPathApplied) {
+        notes.push("A strong candidate fast path was used.");
+    }
+    const topCandidate = scorecard.topCandidates?.[0];
+    if (topCandidate?.retrievalReasons?.length) {
+        notes.push(`Top retrieval signals: ${topCandidate.retrievalReasons.slice(0, 2).join(", ")}.`);
+    }
+    if (topCandidate?.policyReasons?.length) {
+        notes.push(`Top policy signals: ${topCandidate.policyReasons.slice(0, 2).join(", ")}.`);
+    }
+    if (scorecard.rejectedCandidates?.length) {
+        notes.push(`Runner-up candidates withheld: ${scorecard.rejectedCandidates.map((candidate) => candidate.id).join(", ")}.`);
+    }
+    return notes;
+};
+const summarizeScorecard = (scorecard) => scorecard
+    ? {
+        mode: scorecard.mode,
+        interventionStrength: scorecard.interventionStrength,
+        riskLevel: scorecard.riskLevel,
+        recommendation: scorecard.recommendation,
+        actionReason: summarizeActionReason(scorecard),
+        trustSummary: summarizeTrust(scorecard),
+        retrievalNotes: summarizeRetrievalNotes(scorecard),
+        retrievalPolicySummary: buildRetrievalPolicyInspectionSummary(scorecard),
+        confidence: scorecard.confidence,
+        budgetClass: scorecard.budgetClass,
+        selectedCandidateIds: scorecard.selectedCandidateIds,
+        rejectedCandidates: scorecard.rejectedCandidates?.slice(0, 3).map((candidate) => ({
+            id: candidate.id,
+            reasonCodes: candidate.reasonCodes
+        })) ?? [],
+        reasons: scorecard.reasons?.slice(0, 2),
+        nodes: scorecard.nodes?.slice(0, 3).map((node) => ({
+            id: node.id,
+            state: node.state,
+            riskLevel: node.riskLevel,
+            helped: node.helped,
+            harmed: node.harmed
+        })) ?? []
+    }
+    : undefined;
+export const createSharedBehaviorLoop = (adapter, options = {}) => {
+    let promptRuntime;
+    let runtime;
+    const promptLookups = new Map();
+    const getPromptRuntime = () => {
+        promptRuntime ??= createSharedPromptRuntime(adapter, options);
+        return promptRuntime;
+    };
+    const getRuntime = async () => {
+        runtime ??= createSharedRuntime(adapter, options);
+        return runtime;
+    };
+    return {
+        async lookupHints(args) {
+            if (args.sessionId) {
+                const existingRuntime = await getRuntime();
+                existingRuntime.resetSession(args.sessionId);
+            }
+            const fullRuntime = await getRuntime();
+            await fullRuntime.signalHostEvent({
+                host: adapter,
+                sessionId: args.sessionId,
+                cwd: args.cwd,
+                userMessage: args.prompt,
+                taskSummary: args.prompt
+            }, "prompt_lookup");
+            const context = {
+                host: adapter,
+                sessionId: args.sessionId,
+                cwd: args.cwd,
+                userMessage: args.prompt,
+                taskSummary: args.prompt
+            };
+            const result = await getPromptRuntime().beforePromptBuild(context);
+            promptLookups.set(args.sessionId ?? "global", {
+                context,
+                injectedNodeIds: result.input.injected_node_ids
+            });
+            return {
+                mode: result.mode,
+                text: result.text,
+                notice: result.notice,
+                injectedNodeIds: result.input.injected_node_ids,
+                summary: summarizeScorecard(result.scorecard),
+                deliveryMode: result.deliveryMode,
+                delivered: result.delivered
+            };
+        },
+        async signalHostEvent(args) {
+            const fullRuntime = await getRuntime();
+            return fullRuntime.signalHostEvent({
+                host: adapter,
+                sessionId: args.sessionId,
+                cwd: args.cwd,
+                userMessage: "",
+                taskSummary: args.trigger
+            }, args.trigger);
+        },
+        async recordToolResult(args) {
+            const fullRuntime = await getRuntime();
+            const event = await fullRuntime.persistToolResult({
+                sessionId: args.sessionId,
+                toolName: args.toolName,
+                inputSummary: args.inputSummary,
+                outputSummary: args.outputSummary,
+                errorSignature: args.errorSignature,
+                exitCode: args.exitCode,
+                status: args.status
+            });
+            return {
+                status: "recorded",
+                toolName: event.tool_name,
+                eventStatus: event.status,
+                hasErrorSignature: Boolean(event.error_signature),
+                exitCode: event.exit_code
+            };
+        },
+        async finalizeTask(args) {
+            const fullRuntime = await getRuntime();
+            const promptLookup = promptLookups.get(args.sessionId);
+            const input = await fullRuntime.finalizeTask({
+                host: adapter,
+                sessionId: args.sessionId,
+                cwd: args.cwd ?? promptLookup?.context.cwd,
+                userMessage: args.prompt ?? "",
+                taskSummary: args.prompt ?? promptLookup?.context.taskSummary,
+                contextSummary: args.contextSummary,
+                injectedNodeIds: args.injectedNodeIds ?? promptLookup?.injectedNodeIds
+            });
+            promptLookups.delete(args.sessionId ?? "global");
+            return {
+                status: "finalized",
+                taskType: input.task_type,
+                outcomeSignal: input.outcome_signal,
+                injectedNodeIds: input.injected_node_ids,
+                recordedToolEvents: input.tool_events.length,
+                feedbackHint: input.injected_node_ids.length > 0
+                    ? "If the injected guidance helped or harmed this task, call experienceengine_quick_feedback."
+                    : undefined
+            };
+        },
+        async waitForBackgroundLearning() {
+            const fullRuntime = await getRuntime();
+            await fullRuntime.waitForBackgroundLearning();
+        }
+    };
+};
+//# sourceMappingURL=behavior-loop.js.map

package/dist/adapters/shared-mcp/behavior-loop.js.map

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

package/dist/adapters/shared-mcp/server.d.ts

@@ -0,0 +1,113 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type FeedbackValue } from "../../interaction/service.js";
+import { type ExperienceAdapter } from "../../interaction/operational-service.js";
+import { ExperienceOperationalActionsService, type OperationalActionsDeps } from "../../interaction/operational-actions-service.js";
+import { ExperienceStateArtifactService } from "../../interaction/state-artifact-service.js";
+import type { DeliveryState, ExperienceNodeType, ExperienceState, TaskType } from "../../types/domain.js";
+import type { HygieneFindingType, HygieneSeverity } from "../../maintenance/experience-hygiene.js";
+import type { ExportDraftRisk } from "../../maintenance/experience-export-drafts.js";
+import { type SharedServerOptions } from "./behavior-loop.js";
+export type SharedMcpServerOptions = SharedServerOptions & {
+    operationalActionsDeps?: OperationalActionsDeps;
+    operationalActionsService?: ExperienceOperationalActionsService;
+    stateArtifactService?: ExperienceStateArtifactService;
+};
+type SharedRecentMode = "all" | "injected";
+type SharedScopeArgs = {
+    cwd?: string;
+};
+export declare const createSharedInteractionSurface: (adapter: ExperienceAdapter, options?: SharedMcpServerOptions) => {
+    inspectLast(): Promise<import("../../interaction/service.js").ExperienceLastInspection | undefined>;
+    inspectRecent(args?: {
+        mode?: SharedRecentMode;
+        limit?: number;
+    }): Promise<import("../../interaction/service.js").ExperienceRecentInspection[]>;
+    listActiveNodes(): Promise<import("../../interaction/service.js").ExperienceNodeSummary[]>;
+    inspectNode(args: {
+        nodeId: string;
+    }): Promise<import("../../interaction/service.js").ExperienceNodeDetail | undefined>;
+    listNodesByState(args: {
+        state: ExperienceState;
+    }): Promise<import("../../interaction/service.js").ExperienceNodeSummary[]>;
+    listNodesByType(args: {
+        nodeType: ExperienceNodeType;
+    }): Promise<import("../../interaction/service.js").ExperienceNodeSummary[]>;
+    inspectLearningSummary(): Promise<import("../../interaction/service.js").ExperienceLearningSummary>;
+    inspectRepoSummary(args?: SharedScopeArgs): Promise<import("../../interaction/repo-summary.js").ExperienceRepoSummary>;
+    inspectReview(args?: SharedScopeArgs & {
+        limit?: number;
+    }): Promise<import("../../maintenance/operator-review-flow.js").OperatorReviewReport>;
+    inspectGovernance(args?: SharedScopeArgs): Promise<{
+        scopeId: string;
+        status: "clear" | "attention";
+        recentAutomaticActions: number;
+        failedRuns: number;
+        pendingApprovals: number;
+        lastRunStatus?: string;
+        lastFailureClass?: string;
+        recentRuns: Array<{
+            runId: string;
+            trigger: string;
+            status: string;
+            failureClass?: string;
+            updatedAt: string;
+        }>;
+        recentActions: Array<{
+            actionId: string;
+            planId?: string;
+            actionType: string;
+            status: string;
+            rollbackRef?: string;
+            updatedAt: string;
+        }>;
+    }>;
+    inspectGovernancePendingApprovals(args?: SharedScopeArgs): Promise<{
+        scopeId: string;
+        approvals: Array<{
+            approvalId: string;
+            actionId: string;
+            planId?: string;
+            status: string;
+            diffSummary?: string;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+    }>;
+    inspectHygiene(args?: {
+        cwd?: string;
+        type?: HygieneFindingType;
+        severity?: HygieneSeverity;
+        limit?: number;
+    }): Promise<import("../../maintenance/experience-hygiene.js").HygieneReviewReport>;
+    inspectExportDrafts(args?: {
+        cwd?: string;
+        nodeId?: string;
+        nodeType?: ExperienceNodeType;
+        taskFamily?: TaskType;
+        state?: ExperienceState;
+        deliveryState?: DeliveryState;
+        risk?: ExportDraftRisk;
+        limit?: number;
+    }): Promise<import("../../maintenance/experience-export-drafts.js").ExperienceExportDraftReport>;
+    explainLastDecision(args: {
+        cwd?: string;
+        userMessage: string;
+    }): Promise<string>;
+    feedbackLast(args: {
+        feedback: FeedbackValue;
+    }): Promise<import("../../interaction/service.js").FeedbackResult>;
+    feedbackNode(args: {
+        nodeId: string;
+        feedback: FeedbackValue;
+    }): Promise<import("../../interaction/service.js").FeedbackResult>;
+    disableScope(args?: SharedScopeArgs): Promise<import("../../interaction/service.js").ScopeToggleResult>;
+    enableScope(args?: SharedScopeArgs): Promise<import("../../interaction/service.js").ScopeToggleResult>;
+    coolNode(args: {
+        nodeId: string;
+    }): Promise<import("../../interaction/service.js").NodeLifecycleResult>;
+    retireNode(args: {
+        nodeId: string;
+    }): Promise<import("../../interaction/service.js").NodeLifecycleResult>;
+};
+export declare const createSharedMcpServer: (adapter: ExperienceAdapter, options?: SharedMcpServerOptions) => McpServer;
+export {};