@alan512/experienceengine 0.1.3 → 0.2.1

package/dist/adapters/codex/action-registry.js

@@ -0,0 +1,277 @@
+import { z } from "zod";
+export const createCodexActionRegistry = (deps) => {
+    const actions = [
+        {
+            id: "plan_install",
+            title: "Plan Install",
+            summary: "Create an install plan for a supported adapter.",
+            category: "admin",
+            riskLevel: "high",
+            requiresConfirmation: true,
+            inputSchema: z.object({
+                adapter: z.enum(["openclaw", "claude-code", "codex"])
+            }),
+            examplePayload: { adapter: "codex" },
+            handler: async ({ adapter }) => deps.operationalActions.planOperation({
+                adapter: adapter,
+                operation: "install"
+            })
+        },
+        {
+            id: "plan_repair",
+            title: "Plan Repair",
+            summary: "Create a repair plan for a supported adapter.",
+            category: "admin",
+            riskLevel: "high",
+            requiresConfirmation: true,
+            inputSchema: z.object({
+                adapter: z.enum(["openclaw", "claude-code", "codex"])
+            }),
+            examplePayload: { adapter: "codex" },
+            handler: async ({ adapter }) => deps.operationalActions.planOperation({
+                adapter: adapter,
+                operation: "repair"
+            })
+        },
+        {
+            id: "plan_upgrade",
+            title: "Plan Upgrade",
+            summary: "Create an upgrade plan for a supported adapter.",
+            category: "admin",
+            riskLevel: "high",
+            requiresConfirmation: true,
+            inputSchema: z.object({
+                adapter: z.enum(["openclaw", "claude-code", "codex"])
+            }),
+            examplePayload: { adapter: "codex" },
+            handler: async ({ adapter }) => deps.operationalActions.planOperation({
+                adapter: adapter,
+                operation: "upgrade"
+            })
+        },
+        {
+            id: "execute_operational_plan",
+            title: "Execute Operational Plan",
+            summary: "Execute a previously planned install, repair, or upgrade operation.",
+            category: "admin",
+            riskLevel: "high",
+            requiresConfirmation: true,
+            inputSchema: z.object({
+                planId: z.string().min(1),
+                confirmationToken: z.string().min(1)
+            }),
+            examplePayload: { planId: "plan-123", confirmationToken: "confirm-123" },
+            handler: async ({ planId, confirmationToken }) => deps.operationalActions.executePlannedOperation({
+                planId: String(planId),
+                confirmationToken: String(confirmationToken)
+            })
+        },
+        {
+            id: "plan_backup",
+            title: "Plan Backup",
+            summary: "Create a backup plan for managed EE state.",
+            category: "maintenance",
+            riskLevel: "high",
+            requiresConfirmation: true,
+            examplePayload: {},
+            handler: async () => deps.stateArtifacts.planOperation({ operation: "backup" })
+        },
+        {
+            id: "plan_export",
+            title: "Plan Export",
+            summary: "Create an export plan for managed EE state.",
+            category: "maintenance",
+            riskLevel: "high",
+            requiresConfirmation: true,
+            examplePayload: {},
+            handler: async () => deps.stateArtifacts.planOperation({ operation: "export" })
+        },
+        {
+            id: "plan_import",
+            title: "Plan Import",
+            summary: "Create an import plan for an EE snapshot.",
+            category: "maintenance",
+            riskLevel: "high",
+            requiresConfirmation: true,
+            inputSchema: z.object({
+                importPath: z.string().min(1)
+            }),
+            examplePayload: { importPath: "/tmp/experienceengine-snapshot" },
+            handler: async ({ importPath }) => deps.stateArtifacts.planOperation({ operation: "import", importPath: String(importPath) })
+        },
+        {
+            id: "plan_rollback",
+            title: "Plan Rollback",
+            summary: "Create a rollback plan for managed EE state.",
+            category: "maintenance",
+            riskLevel: "high",
+            requiresConfirmation: true,
+            inputSchema: z.object({
+                backupId: z.string().min(1)
+            }),
+            examplePayload: { backupId: "backup-123" },
+            handler: async ({ backupId }) => deps.stateArtifacts.planOperation({ operation: "rollback", backupId: String(backupId) })
+        },
+        {
+            id: "execute_state_plan",
+            title: "Execute State Plan",
+            summary: "Execute a previously planned backup, export, import, or rollback operation.",
+            category: "maintenance",
+            riskLevel: "high",
+            requiresConfirmation: true,
+            inputSchema: z.object({
+                planId: z.string().min(1),
+                confirmationToken: z.string().min(1)
+            }),
+            examplePayload: { planId: "plan-123", confirmationToken: "confirm-123" },
+            handler: async ({ planId, confirmationToken }) => deps.stateArtifacts.executePlannedOperation({
+                planId: String(planId),
+                confirmationToken: String(confirmationToken)
+            })
+        },
+        {
+            id: "check_update",
+            title: "Check Update",
+            summary: "Check release or update status for an adapter.",
+            category: "maintenance",
+            riskLevel: "low",
+            requiresConfirmation: false,
+            inputSchema: z.object({
+                adapter: z.enum(["openclaw", "claude-code", "codex"])
+            }),
+            examplePayload: { adapter: "codex" },
+            handler: async ({ adapter }) => deps.operationalSurface.checkUpdate(adapter)
+        },
+        {
+            id: "inspect_recent_history",
+            title: "Inspect Recent History",
+            summary: "Inspect recent EE history, optionally filtered to injected turns.",
+            category: "inspect",
+            riskLevel: "low",
+            requiresConfirmation: false,
+            inputSchema: z.object({
+                mode: z.enum(["all", "injected"]).optional(),
+                limit: z.number().int().positive().optional()
+            }),
+            examplePayload: { mode: "injected", limit: 10 },
+            handler: async ({ mode, limit }) => deps.interactionSurface.inspectRecent({
+                mode: mode,
+                limit: typeof limit === "number" ? limit : undefined
+            })
+        },
+        {
+            id: "inspect_node_detail",
+            title: "Inspect Node Detail",
+            summary: "Inspect one EE node by id.",
+            category: "inspect",
+            riskLevel: "low",
+            requiresConfirmation: false,
+            inputSchema: z.object({
+                nodeId: z.string().min(1)
+            }),
+            examplePayload: { nodeId: "node_123" },
+            handler: async ({ nodeId }) => deps.interactionSurface.inspectNode({ nodeId: String(nodeId) })
+        },
+        {
+            id: "inspect_nodes_by_state",
+            title: "Inspect Nodes By State",
+            summary: "Inspect EE nodes filtered by lifecycle state.",
+            category: "inspect",
+            riskLevel: "low",
+            requiresConfirmation: false,
+            inputSchema: z.object({
+                state: z.enum(["candidate", "priority_candidate", "active", "cooling", "retired"])
+            }),
+            examplePayload: { state: "active" },
+            handler: async ({ state }) => deps.interactionSurface.listNodesByState({ state: state })
+        },
+        {
+            id: "inspect_nodes_by_type",
+            title: "Inspect Nodes By Type",
+            summary: "Inspect EE nodes filtered by node type.",
+            category: "inspect",
+            riskLevel: "low",
+            requiresConfirmation: false,
+            inputSchema: z.object({
+                nodeType: z.enum(["strategy", "warning"])
+            }),
+            examplePayload: { nodeType: "warning" },
+            handler: async ({ nodeType }) => deps.interactionSurface.listNodesByType({ nodeType: nodeType })
+        },
+        {
+            id: "inspect_learning_summary",
+            title: "Inspect Learning Summary",
+            summary: "Inspect the current learning summary.",
+            category: "inspect",
+            riskLevel: "low",
+            requiresConfirmation: false,
+            examplePayload: {},
+            handler: async () => deps.interactionSurface.inspectLearningSummary()
+        },
+        {
+            id: "inspect_backup_inventory",
+            title: "Inspect Backup Inventory",
+            summary: "Inspect managed EE backups available for rollback or export review.",
+            category: "inspect",
+            riskLevel: "low",
+            requiresConfirmation: false,
+            examplePayload: {},
+            handler: async () => deps.stateArtifacts.listBackups()
+        },
+        {
+            id: "feedback_node",
+            title: "Feedback Node",
+            summary: "Record helped or harmed feedback for a specific EE node.",
+            category: "state",
+            riskLevel: "low",
+            requiresConfirmation: false,
+            inputSchema: z.object({
+                nodeId: z.string().min(1),
+                feedback: z.enum(["helped", "harmed"])
+            }),
+            examplePayload: { nodeId: "node_123", feedback: "helped" },
+            handler: async ({ nodeId, feedback }) => deps.interactionSurface.feedbackNode({
+                nodeId: String(nodeId),
+                feedback: feedback
+            })
+        },
+        {
+            id: "set_scope_intervention_state",
+            title: "Set Scope Intervention State",
+            summary: "Enable or disable EE interventions for a working-directory scope.",
+            category: "state",
+            riskLevel: "low",
+            requiresConfirmation: false,
+            inputSchema: z.object({
+                action: z.enum(["enable", "disable"]),
+                cwd: z.string().optional()
+            }),
+            examplePayload: { action: "disable", cwd: "/repo" },
+            handler: async ({ action, cwd }) => action === "disable"
+                ? deps.interactionSurface.disableScope({ cwd: typeof cwd === "string" ? cwd : undefined })
+                : deps.interactionSurface.enableScope({ cwd: typeof cwd === "string" ? cwd : undefined })
+        },
+        {
+            id: "set_node_lifecycle",
+            title: "Set Node Lifecycle",
+            summary: "Move a specific EE node into cooling or retired lifecycle state.",
+            category: "state",
+            riskLevel: "low",
+            requiresConfirmation: false,
+            inputSchema: z.object({
+                action: z.enum(["cool", "retire"]),
+                nodeId: z.string().min(1)
+            }),
+            examplePayload: { action: "cool", nodeId: "node_123" },
+            handler: async ({ action, nodeId }) => action === "cool"
+                ? deps.interactionSurface.coolNode({ nodeId: String(nodeId) })
+                : deps.interactionSurface.retireNode({ nodeId: String(nodeId) })
+        }
+    ];
+    const byId = new Map(actions.map((action) => [action.id, action]));
+    return {
+        list: () => actions,
+        get: (id) => byId.get(id)
+    };
+};
+//# sourceMappingURL=action-registry.js.map

package/dist/adapters/codex/action-registry.js.map

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

package/dist/adapters/codex/broker-tools.d.ts

@@ -0,0 +1,114 @@
+import { z } from "zod";
+import type { CodexActionRegistry } from "./action-registry.js";
+export declare const listCodexActionsSchema: z.ZodObject<{
+    category: z.ZodOptional<z.ZodEnum<["inspect", "state", "admin", "maintenance"]>>;
+    riskLevel: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+}, "strip", z.ZodTypeAny, {
+    riskLevel?: "low" | "medium" | "high" | undefined;
+    category?: "state" | "inspect" | "admin" | "maintenance" | undefined;
+}, {
+    riskLevel?: "low" | "medium" | "high" | undefined;
+    category?: "state" | "inspect" | "admin" | "maintenance" | undefined;
+}>;
+export declare const prepareCodexActionSchema: z.ZodObject<{
+    actionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    actionId: string;
+}, {
+    actionId: string;
+}>;
+export declare const executeCodexActionSchema: z.ZodObject<{
+    actionId: z.ZodString;
+    payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    actionId: string;
+    payload?: Record<string, unknown> | undefined;
+}, {
+    actionId: string;
+    payload?: Record<string, unknown> | undefined;
+}>;
+type JsonContract = {
+    type: "string";
+    enum?: string[];
+    optional?: boolean;
+} | {
+    type: "number";
+    integer?: boolean;
+    positive?: boolean;
+    optional?: boolean;
+} | {
+    type: "boolean";
+    optional?: boolean;
+} | {
+    type: "record";
+    valueType: string;
+    optional?: boolean;
+} | {
+    type: "object";
+    optional?: boolean;
+    required: string[];
+    properties: Record<string, JsonContract>;
+} | {
+    type: "unknown";
+    optional?: boolean;
+};
+export declare const createCodexBrokerFacade: (registry: CodexActionRegistry) => {
+    listActions(args: z.infer<typeof listCodexActionsSchema>): {
+        actions: {
+            id: string;
+            title: string;
+            summary: string;
+            category: import("./action-registry.js").CodexActionCategory;
+            riskLevel: import("./action-registry.js").CodexActionRiskLevel;
+            requiresConfirmation: boolean;
+        }[];
+    };
+    prepareAction(args: z.infer<typeof prepareCodexActionSchema>): {
+        action: {
+            id: string;
+            title: string;
+            summary: string;
+            category: import("./action-registry.js").CodexActionCategory;
+            riskLevel: import("./action-registry.js").CodexActionRiskLevel;
+            requiresConfirmation: boolean;
+        };
+        parameter_contract: {
+            type: "string";
+            enum?: string[];
+            optional?: boolean;
+        } | {
+            type: "number";
+            integer?: boolean;
+            positive?: boolean;
+            optional?: boolean;
+        } | {
+            type: "boolean";
+            optional?: boolean;
+        } | {
+            type: "record";
+            valueType: string;
+            optional?: boolean;
+        } | {
+            type: "object";
+            optional?: boolean;
+            required: string[];
+            properties: Record<string, JsonContract>;
+        } | {
+            type: "unknown";
+            optional?: boolean;
+        } | {
+            type: string;
+            required: never[];
+            properties: {};
+        };
+        example_payload: Record<string, unknown>;
+        risk_description: string;
+        impact_summary: string;
+        suggested_next_step: string;
+    };
+    executeAction(args: z.infer<typeof executeCodexActionSchema>): Promise<{
+        actionId: string;
+        result: unknown;
+    }>;
+};
+export {};

package/dist/adapters/codex/broker-tools.js

@@ -0,0 +1,130 @@
+import { z } from "zod";
+export const listCodexActionsSchema = z.object({
+    category: z.enum(["inspect", "state", "admin", "maintenance"]).optional(),
+    riskLevel: z.enum(["low", "medium", "high"]).optional()
+});
+export const prepareCodexActionSchema = z.object({
+    actionId: z.string().min(1)
+});
+export const executeCodexActionSchema = z.object({
+    actionId: z.string().min(1),
+    payload: z.record(z.string(), z.unknown()).optional()
+});
+const serializeZodSchema = (schema) => {
+    if (schema instanceof z.ZodOptional) {
+        return {
+            ...serializeZodSchema(schema.unwrap()),
+            optional: true
+        };
+    }
+    if (schema instanceof z.ZodObject) {
+        const shape = schema.shape;
+        const properties = Object.fromEntries(Object.entries(shape).map(([key, value]) => [key, serializeZodSchema(value)]));
+        return {
+            type: "object",
+            required: Object.entries(properties)
+                .filter(([, value]) => !value.optional)
+                .map(([key]) => key),
+            properties
+        };
+    }
+    if (schema instanceof z.ZodEnum) {
+        return {
+            type: "string",
+            enum: [...schema.options]
+        };
+    }
+    if (schema instanceof z.ZodString) {
+        return { type: "string" };
+    }
+    if (schema instanceof z.ZodNumber) {
+        const checks = schema._def.checks ?? [];
+        return {
+            type: "number",
+            integer: checks.some((check) => check.kind === "int"),
+            positive: checks.some((check) => check.kind === "min" && check.value > 0)
+        };
+    }
+    if (schema instanceof z.ZodBoolean) {
+        return { type: "boolean" };
+    }
+    if (schema instanceof z.ZodRecord) {
+        return {
+            type: "record",
+            valueType: "unknown"
+        };
+    }
+    return { type: "unknown" };
+};
+const describeRisk = (riskLevel, requiresConfirmation) => {
+    if (riskLevel === "high") {
+        return requiresConfirmation
+            ? "High-impact action. Review the generated plan and require explicit confirmation before execution."
+            : "High-impact action. Validate arguments carefully before execution.";
+    }
+    if (riskLevel === "medium") {
+        return "Medium-impact action. Verify scope and arguments before execution.";
+    }
+    return "Low-risk action. Safe for routine inspection or scoped state updates.";
+};
+const describeNextStep = (action) => {
+    if (!action) {
+        return "Unknown action.";
+    }
+    if (action.requiresConfirmation) {
+        return `Call experienceengine_execute_action with actionId=${action.id} to create or continue the guarded flow, then require explicit confirmation before the matching execute step.`;
+    }
+    return `Call experienceengine_execute_action with actionId=${action.id} and a payload matching parameter_contract.`;
+};
+export const createCodexBrokerFacade = (registry) => ({
+    listActions(args) {
+        const actions = registry
+            .list()
+            .filter((action) => (args.category ? action.category === args.category : true))
+            .filter((action) => (args.riskLevel ? action.riskLevel === args.riskLevel : true))
+            .map((action) => ({
+            id: action.id,
+            title: action.title,
+            summary: action.summary,
+            category: action.category,
+            riskLevel: action.riskLevel,
+            requiresConfirmation: action.requiresConfirmation
+        }));
+        return { actions };
+    },
+    prepareAction(args) {
+        const action = registry.get(args.actionId);
+        if (!action) {
+            throw new Error(`Unknown action: ${args.actionId}`);
+        }
+        return {
+            action: {
+                id: action.id,
+                title: action.title,
+                summary: action.summary,
+                category: action.category,
+                riskLevel: action.riskLevel,
+                requiresConfirmation: action.requiresConfirmation
+            },
+            parameter_contract: action.inputSchema
+                ? serializeZodSchema(action.inputSchema)
+                : { type: "object", required: [], properties: {} },
+            example_payload: action.examplePayload ?? {},
+            risk_description: describeRisk(action.riskLevel, action.requiresConfirmation),
+            impact_summary: action.summary,
+            suggested_next_step: describeNextStep(action)
+        };
+    },
+    async executeAction(args) {
+        const action = registry.get(args.actionId);
+        if (!action) {
+            throw new Error(`Unknown action: ${args.actionId}`);
+        }
+        const result = await action.handler(args.payload ?? {});
+        return {
+            actionId: action.id,
+            result
+        };
+    }
+});
+//# sourceMappingURL=broker-tools.js.map

package/dist/adapters/codex/broker-tools.js.map

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

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

@@ -2,6 +2,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { type FeedbackValue } from "../../interaction/service.js";
 import { ExperienceOperationalActionsService, type OperationalActionsDeps } from "../../interaction/operational-actions-service.js";
 import { ExperienceStateArtifactService } from "../../interaction/state-artifact-service.js";
+import { ExperienceRuntimeService } from "../../runtime/service.js";
 import type { ExperienceNodeType, ExperienceState, ToolEventStatus } from "../../types/domain.js";
 type CodexLookupArgs = {
     cwd?: string;
@@ -30,6 +31,7 @@ type CodexServerOptions = {
     operationalActionsDeps?: OperationalActionsDeps;
     operationalActionsService?: ExperienceOperationalActionsService;
     stateArtifactService?: ExperienceStateArtifactService;
+    runtimeOptions?: ConstructorParameters<typeof ExperienceRuntimeService>[2];
 };
 type CodexRecentMode = "all" | "injected";
 type CodexScopeArgs = {
@@ -48,6 +50,13 @@ export declare const createCodexBehaviorLoop: (options?: CodexServerOptions) =>
             actionReason: string | undefined;
             trustSummary: string | undefined;
             retrievalNotes: string[];
+            confidence: string | undefined;
+            budgetClass: string | undefined;
+            selectedCandidateIds: string[] | undefined;
+            rejectedCandidates: {
+                id: string;
+                reasonCodes: string[] | undefined;
+            }[];
             reasons: string[] | undefined;
             nodes: {
                 id: string;
@@ -75,6 +84,7 @@ export declare const createCodexBehaviorLoop: (options?: CodexServerOptions) =>
         recordedToolEvents: number;
         feedbackHint: string | undefined;
     }>;
+    waitForBackgroundLearning(): Promise<void>;
 };
 export declare const createCodexInteractionSurface: (options?: CodexServerOptions) => {
     inspectLast(): Promise<import("../../interaction/service.js").ExperienceLastInspection | undefined>;
@@ -94,6 +104,10 @@ export declare const createCodexInteractionSurface: (options?: CodexServerOption
     }): Promise<import("../../interaction/service.js").ExperienceNodeSummary[]>;
     inspectLearningSummary(): Promise<import("../../interaction/service.js").ExperienceLearningSummary>;
     inspectRepoSummary(args?: CodexScopeArgs): Promise<import("../../interaction/repo-summary.js").ExperienceRepoSummary>;
+    explainLastDecision(args: {
+        cwd?: string;
+        userMessage: string;
+    }): Promise<string>;
     feedbackLast(args: {
         feedback: FeedbackValue;
     }): Promise<import("../../interaction/service.js").FeedbackResult>;
@@ -122,6 +136,13 @@ export declare const lookupCodexExperienceHints: (args: CodexLookupArgs, options
         actionReason: string | undefined;
         trustSummary: string | undefined;
         retrievalNotes: string[];
+        confidence: string | undefined;
+        budgetClass: string | undefined;
+        selectedCandidateIds: string[] | undefined;
+        rejectedCandidates: {
+            id: string;
+            reasonCodes: string[] | undefined;
+        }[];
         reasons: string[] | undefined;
         nodes: {
             id: string;