@x12i/memorix-scoper 1.1.0

package/dist/guard.test.js

@@ -0,0 +1,13 @@
+import { describe, expect, it, beforeEach } from "vitest";
+import { enterScopeTrace, __resetScopeTracesForTests } from "./guard.js";
+import { ScoperError } from "@x12i/memorix-scoper-contracts";
+describe("invocation guard", () => {
+    beforeEach(() => __resetScopeTracesForTests());
+    it("rejects recursive scope entry", () => {
+        const exit = enterScopeTrace("t1");
+        expect(() => enterScopeTrace("t1")).toThrow(ScoperError);
+        exit();
+        expect(() => enterScopeTrace("t1")).not.toThrow();
+    });
+});
+//# sourceMappingURL=guard.test.js.map

package/dist/guard.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.test.js","sourceRoot":"","sources":["../src/guard.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAE7D,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,UAAU,CAAC,GAAG,EAAE,CAAC,0BAA0B,EAAE,CAAC,CAAC;IAC/C,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACzD,IAAI,EAAE,CAAC;QACP,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { scope, type ScoperDependencies } from "./coordinator.js";
+export { createScoper, type CreateScoperOptions, type Scoper } from "./create-scoper.js";
+export { createScoperMcpServer, type CreateScoperMcpServerDeps, type ScoperMcpServer, type ScoperMcpTool, } from "./mcp-server.js";
+export type { ScoperReasoner, ReasonerInput } from "./reasoner/types.js";
+export { ScriptedReasoner, type ScriptedReasonerOptions } from "./reasoner/scripted.js";
+export { AiDispatcherReasoner, dispatcherOptionsFromEnv, type AiDispatcherReasonerOptions, } from "./reasoner/ai-dispatcher.js";
+export { enterScopeTrace, resetScopeTraces } from "./recursion.js";
+export { validatePlanAgainstCatalog, validateEpistemicConsistency, assertNotPromotingPolicyToReachable, } from "./validation.js";
+export * from "./profiles.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EACL,qBAAqB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,KAAK,2BAA2B,GACjC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,mCAAmC,GACpC,MAAM,iBAAiB,CAAC;AACzB,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { scope } from "./coordinator.js";
+export { createScoper } from "./create-scoper.js";
+export { createScoperMcpServer, } from "./mcp-server.js";
+export { ScriptedReasoner } from "./reasoner/scripted.js";
+export { AiDispatcherReasoner, dispatcherOptionsFromEnv, } from "./reasoner/ai-dispatcher.js";
+export { enterScopeTrace, resetScopeTraces } from "./recursion.js";
+export { validatePlanAgainstCatalog, validateEpistemicConsistency, assertNotPromotingPolicyToReachable, } from "./validation.js";
+export * from "./profiles.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAA2B,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAyC,MAAM,oBAAoB,CAAC;AACzF,OAAO,EACL,qBAAqB,GAItB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAgC,MAAM,wBAAwB,CAAC;AACxF,OAAO,EACL,oBAAoB,EACpB,wBAAwB,GAEzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,mCAAmC,GACpC,MAAM,iBAAiB,CAAC;AACzB,cAAc,eAAe,CAAC"}

package/dist/mcp-server.d.ts

@@ -0,0 +1,58 @@
+/**
+ * FR-SC — Scoper as an ai-dispatcher MCP server.
+ *
+ * Hosts bind TrustedExecutionContext + SDK at create time. Tool args never
+ * carry org/credentials (same model as scoper-service HTTP).
+ *
+ * Attach:
+ * ```ts
+ * import { createAiDispatcher } from "@x12i/ai-dispatcher";
+ * import { createScoper, createScoperMcpServer } from "@x12i/memorix-scoper";
+ *
+ * const scoper = createScoper({ sdkConfig: { memorixBaseUrls: [...] } });
+ * const dispatcher = createAiDispatcher({
+ *   // providers…
+ *   mcp: {
+ *     servers: [
+ *       createScoperMcpServer({
+ *         scoper,
+ *         context: { orgId, agentIds, caller, traceId },
+ *       }),
+ *     ],
+ *   },
+ * });
+ * ```
+ *
+ * Exposed tools: `scoper__scope`, `scoper__subject_data`.
+ */
+import { type TrustedExecutionContext } from "@x12i/memorix-scoper-contracts";
+import type { Scoper } from "./create-scoper.js";
+import { type CreateScoperOptions } from "./create-scoper.js";
+/** Shape compatible with `@x12i/ai-dispatcher` DispatcherMcpServer (1.4+). */
+export type ScoperMcpTool = {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+};
+export type ScoperMcpServer = {
+    id: string;
+    tools: ScoperMcpTool[];
+    callTool: (name: string, args: Record<string, unknown>, context?: unknown) => Promise<unknown> | unknown;
+    listTools?: () => Promise<ScoperMcpTool[]>;
+};
+export type CreateScoperMcpServerDeps = {
+    /** Pre-built scoper (preferred when sharing with HTTP host). */
+    scoper?: Scoper;
+    /** Used when `scoper` is omitted. */
+    createOptions?: CreateScoperOptions;
+    /** Trusted host context — never taken from tool args. */
+    context: TrustedExecutionContext;
+    /** MCP server id (default `scoper`). Must match `^[A-Za-z0-9_-]+$`. */
+    id?: string;
+};
+/**
+ * Build an ai-dispatcher MCP server for Scoper tools.
+ * Tool set is static — `listTools` returns the same schemas; `refreshMcp` is a no-op refresh.
+ */
+export declare function createScoperMcpServer(deps: CreateScoperMcpServerDeps): ScoperMcpServer;
+//# sourceMappingURL=mcp-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAKL,KAAK,uBAAuB,EAC7B,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAI5E,8EAA8E;AAC9E,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,QAAQ,EAAE,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,OAAO,KACd,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,yDAAyD;IACzD,OAAO,EAAE,uBAAuB,CAAC;IACjC,uEAAuE;IACvE,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AA8GF;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,yBAAyB,GAAG,eAAe,CAkCtF"}

package/dist/mcp-server.js

@@ -0,0 +1,166 @@
+/**
+ * FR-SC — Scoper as an ai-dispatcher MCP server.
+ *
+ * Hosts bind TrustedExecutionContext + SDK at create time. Tool args never
+ * carry org/credentials (same model as scoper-service HTTP).
+ *
+ * Attach:
+ * ```ts
+ * import { createAiDispatcher } from "@x12i/ai-dispatcher";
+ * import { createScoper, createScoperMcpServer } from "@x12i/memorix-scoper";
+ *
+ * const scoper = createScoper({ sdkConfig: { memorixBaseUrls: [...] } });
+ * const dispatcher = createAiDispatcher({
+ *   // providers…
+ *   mcp: {
+ *     servers: [
+ *       createScoperMcpServer({
+ *         scoper,
+ *         context: { orgId, agentIds, caller, traceId },
+ *       }),
+ *     ],
+ *   },
+ * });
+ * ```
+ *
+ * Exposed tools: `scoper__scope`, `scoper__subject_data`.
+ */
+import { ScopeRequestSchema, SubjectDataRequestSchema, isScoperError, ScoperError, } from "@x12i/memorix-scoper-contracts";
+import { readSubjectData } from "@x12i/memorix-scoper-sdk";
+import { createScoper } from "./create-scoper.js";
+const UNTRUSTED_KEYS = ["orgId", "credentials", "token", "memorixBaseUrl", "agentIds", "caller"];
+const SCOPE_INPUT_SCHEMA = {
+    type: "object",
+    required: ["profileId", "question"],
+    additionalProperties: false,
+    properties: {
+        profileId: { type: "string", minLength: 1 },
+        question: { type: "string", minLength: 1, maxLength: 16000 },
+        focus: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                subjectIds: { type: "array", items: { type: "string" } },
+                objectTypes: { type: "array", items: { type: "string" } },
+                contentTypes: { type: "array", items: { type: "string" } },
+                tags: { type: "array", items: { type: "string" } },
+            },
+        },
+        budgets: { type: "object", additionalProperties: true },
+        options: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                allowExplore: { type: "boolean" },
+                dryRun: { type: "boolean" },
+                includeUnknowns: { type: "boolean" },
+            },
+        },
+        hints: { type: "object", additionalProperties: true },
+    },
+};
+const SUBJECT_DATA_INPUT_SCHEMA = {
+    type: "object",
+    required: ["recordId", "objectType", "contentType"],
+    additionalProperties: false,
+    properties: {
+        recordId: { type: "string", minLength: 1 },
+        objectType: { type: "string", minLength: 1 },
+        contentType: { type: "string", minLength: 1 },
+        alsoContentTypes: {
+            type: "array",
+            maxItems: 16,
+            items: { type: "string", minLength: 1 },
+        },
+    },
+};
+const TOOLS = [
+    {
+        name: "scope",
+        description: "Run Scoper against Memorix with a ScopeRequest body. Trusted org/agent/caller come from the host — do not pass credentials.",
+        inputSchema: SCOPE_INPUT_SCHEMA,
+    },
+    {
+        name: "subject_data",
+        description: "Read stored Memorix subject pieces for one recordId + objectType + contentType (optional alsoContentTypes).",
+        inputSchema: SUBJECT_DATA_INPUT_SCHEMA,
+    },
+];
+function stripUntrusted(args) {
+    const out = { ...args };
+    for (const key of UNTRUSTED_KEYS) {
+        delete out[key];
+    }
+    return out;
+}
+function mcpOk(payload) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(payload) }],
+    };
+}
+function mcpErr(err) {
+    if (isScoperError(err) || err instanceof ScoperError) {
+        return {
+            isError: true,
+            content: [{ type: "text", text: JSON.stringify(err.toJSON()) }],
+        };
+    }
+    if (err && typeof err === "object" && "issues" in err) {
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        code: "INVALID_REQUEST",
+                        message: "tool args failed schema validation",
+                        details: err,
+                    }),
+                },
+            ],
+        };
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        isError: true,
+        content: [{ type: "text", text: JSON.stringify({ code: "INTERNAL", message }) }],
+    };
+}
+/**
+ * Build an ai-dispatcher MCP server for Scoper tools.
+ * Tool set is static — `listTools` returns the same schemas; `refreshMcp` is a no-op refresh.
+ */
+export function createScoperMcpServer(deps) {
+    const id = deps.id ?? "scoper";
+    if (!/^[A-Za-z0-9_-]+$/.test(id)) {
+        throw new Error(`createScoperMcpServer: id "${id}" must match ^[A-Za-z0-9_-]+$`);
+    }
+    const scoper = deps.scoper ?? createScoper(deps.createOptions ?? {});
+    const context = deps.context;
+    async function callTool(name, args) {
+        try {
+            const body = stripUntrusted(args ?? {});
+            if (name === "scope") {
+                const request = ScopeRequestSchema.parse(body);
+                const bundle = await scoper.scope(request, context);
+                return mcpOk(bundle);
+            }
+            if (name === "subject_data") {
+                const request = SubjectDataRequestSchema.parse(body);
+                const data = await readSubjectData(scoper.deps.sdk.forContext(context), request);
+                return mcpOk(data);
+            }
+            return mcpErr(new ScoperError("INVALID_REQUEST", `Unknown Scoper MCP tool: ${name}`));
+        }
+        catch (err) {
+            return mcpErr(err);
+        }
+    }
+    return {
+        id,
+        tools: TOOLS,
+        callTool,
+        listTools: async () => TOOLS,
+    };
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

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

package/dist/profiles.d.ts

@@ -0,0 +1,2 @@
+export { PROFILES, getProfile, listProfiles, generalProfile, entityInventoryProfile, vulnerabilityProfile, alertLiveProfile, exposureReachabilityProfile, investigationProfile, knowledgeSnapshotProfile, } from "@x12i/memorix-scoper-profiles";
+//# sourceMappingURL=profiles.d.ts.map

package/dist/profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../src/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC"}

package/dist/profiles.js

@@ -0,0 +1,2 @@
+export { PROFILES, getProfile, listProfiles, generalProfile, entityInventoryProfile, vulnerabilityProfile, alertLiveProfile, exposureReachabilityProfile, investigationProfile, knowledgeSnapshotProfile, } from "@x12i/memorix-scoper-profiles";
+//# sourceMappingURL=profiles.js.map

package/dist/profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../src/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC"}

package/dist/reasoner/ai-dispatcher.d.ts

@@ -0,0 +1,24 @@
+import { type AiDispatcher, type AiDispatcherOptions, type AiProviderId } from "@x12i/ai-dispatcher";
+import { type RetrievalPlan } from "@x12i/memorix-scoper-contracts";
+import type { ReasonerInput, ScoperReasoner } from "./types.js";
+export interface AiDispatcherReasonerOptions {
+    dispatcher?: AiDispatcher;
+    dispatcherOptions?: AiDispatcherOptions;
+    /** Default provider for run(); omit to use dispatcher default (openrouter). */
+    provider?: AiProviderId;
+    model?: string;
+}
+/**
+ * AI reasoner via @x12i/ai-dispatcher (gateway only — OpenRouter / Bedrock / OpenAI).
+ * Uses run() only — no tools. One repair attempt is owned by the coordinator.
+ */
+export declare class AiDispatcherReasoner implements ScoperReasoner {
+    private readonly dispatcher;
+    private readonly model;
+    private readonly provider;
+    constructor(options?: AiDispatcherReasonerOptions);
+    proposePlan(input: ReasonerInput): Promise<RetrievalPlan>;
+}
+/** Build dispatcher options from common host env vars (no secrets in request body). */
+export declare function dispatcherOptionsFromEnv(env?: NodeJS.ProcessEnv): AiDispatcherOptions;
+//# sourceMappingURL=ai-dispatcher.d.ts.map

package/dist/reasoner/ai-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-dispatcher.d.ts","sourceRoot":"","sources":["../../src/reasoner/ai-dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAkChE,MAAM,WAAW,2BAA2B;IAC1C,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,iBAAiB,CAAC,EAAE,mBAAmB,CAAC;IACxC,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAe;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;gBAExC,OAAO,GAAE,2BAAgC;IAM/C,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CAwBhE;AAED,uFAAuF;AACvF,wBAAgB,wBAAwB,CACtC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,mBAAmB,CA8BrB"}

package/dist/reasoner/ai-dispatcher.js

@@ -0,0 +1,106 @@
+import { createAiDispatcher, AiDispatcherError, } from "@x12i/ai-dispatcher";
+import { RetrievalPlanSchema, ScoperError, normalizeUpstreamError, } from "@x12i/memorix-scoper-contracts";
+function extractJsonObject(text) {
+    const trimmed = text.trim();
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        const start = trimmed.indexOf("{");
+        const end = trimmed.lastIndexOf("}");
+        if (start >= 0 && end > start) {
+            return JSON.parse(trimmed.slice(start, end + 1));
+        }
+        throw new Error("no JSON object in model response");
+    }
+}
+function buildPrompt(input) {
+    const catalogIds = input.catalog.entries.map((e) => e.id).join(", ");
+    const repair = input.repairOf
+        ? `\nPrevious plan was invalid: ${input.repairOf.error}\nPrevious plan: ${JSON.stringify(input.repairOf.previousPlan)}\nFix the plan.`
+        : "";
+    return [
+        `Profile: ${input.profile.id}`,
+        `Question: ${input.request.question}`,
+        `Allowed catalog entry ids: ${catalogIds}`,
+        `Budgets (immutable — do not attempt to change): ${JSON.stringify(input.budgets)}`,
+        `Epistemic rules: ${input.profile.epistemicRules.join(" | ")}`,
+        "Return ONLY a JSON RetrievalPlan with fields: planId, rationale, steps[], selections[], optional answerDraft.",
+        "Each step needs id, capability, catalogEntryId, args, optional parallelGroup, required.",
+        "No tools. No markdown. JSON only.",
+        repair,
+    ].join("\n");
+}
+/**
+ * AI reasoner via @x12i/ai-dispatcher (gateway only — OpenRouter / Bedrock / OpenAI).
+ * Uses run() only — no tools. One repair attempt is owned by the coordinator.
+ */
+export class AiDispatcherReasoner {
+    dispatcher;
+    model;
+    provider;
+    constructor(options = {}) {
+        this.dispatcher = options.dispatcher ?? createAiDispatcher(options.dispatcherOptions ?? {});
+        this.provider = options.provider ?? options.dispatcherOptions?.provider;
+        this.model = options.model ?? "openai/gpt-4o-mini";
+    }
+    async proposePlan(input) {
+        try {
+            const response = await this.dispatcher.run({
+                ...(this.provider ? { provider: this.provider } : {}),
+                model: this.model,
+                system: [input.profile.systemPrompt, "Return JSON only. No tools."].filter(Boolean).join("\n"),
+                prompt: buildPrompt(input),
+            });
+            const text = response.text?.trim() ? response.text : "";
+            if (!text) {
+                throw new ScoperError("REASONER_INVALID_PLAN", "AI dispatcher returned empty text", {
+                    details: { status: response.status, model: response.model },
+                });
+            }
+            const raw = extractJsonObject(text);
+            return RetrievalPlanSchema.parse(raw);
+        }
+        catch (err) {
+            if (err instanceof AiDispatcherError && err.code === "PROVIDER_NOT_IMPLEMENTED") {
+                throw new ScoperError("PROVIDER_NOT_IMPLEMENTED", err.message, { details: err.details });
+            }
+            if (err instanceof ScoperError)
+                throw err;
+            throw normalizeUpstreamError(err);
+        }
+    }
+}
+/** Build dispatcher options from common host env vars (no secrets in request body). */
+export function dispatcherOptionsFromEnv(env = process.env) {
+    const provider = (env.SCOPER_AI_PROVIDER ?? "openrouter");
+    const options = { provider };
+    if (env.OPENROUTER_API_KEY) {
+        options.openrouter = {
+            apiKey: env.OPENROUTER_API_KEY,
+            ...(env.SCOPER_AI_MODEL && provider === "openrouter"
+                ? { defaultModel: env.SCOPER_AI_MODEL }
+                : {}),
+        };
+    }
+    if (env.AWS_REGION || env.BEDROCK_REGION) {
+        options.bedrock = {
+            region: env.BEDROCK_REGION ?? env.AWS_REGION,
+            ...(env.SCOPER_AI_MODEL && provider === "bedrock"
+                ? { defaultModel: env.SCOPER_AI_MODEL }
+                : {}),
+        };
+    }
+    if (env.OPENAI_API_KEY) {
+        options.openai = {
+            apiKey: env.OPENAI_API_KEY,
+            ...(env.OPENAI_ORG_ID ? { organization: env.OPENAI_ORG_ID } : {}),
+            ...(env.OPENAI_PROJECT_ID ? { project: env.OPENAI_PROJECT_ID } : {}),
+            ...(env.SCOPER_AI_MODEL && provider === "openai"
+                ? { defaultModel: env.SCOPER_AI_MODEL }
+                : {}),
+        };
+    }
+    return options;
+}
+//# sourceMappingURL=ai-dispatcher.js.map

package/dist/reasoner/ai-dispatcher.js.map

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

package/dist/reasoner/ai-dispatcher.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ai-dispatcher.test.d.ts.map

package/dist/reasoner/ai-dispatcher.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-dispatcher.test.d.ts","sourceRoot":"","sources":["../../src/reasoner/ai-dispatcher.test.ts"],"names":[],"mappings":""}

package/dist/reasoner/ai-dispatcher.test.js

@@ -0,0 +1,70 @@
+import { describe, expect, it, vi } from "vitest";
+import { AiDispatcherReasoner } from "./ai-dispatcher.js";
+import { ScoperError } from "@x12i/memorix-scoper-contracts";
+function planningInput() {
+    return {
+        request: { objective: "x" },
+        context: {
+            orgId: "o",
+            agentIds: ["a"],
+            callerId: "c",
+            permissions: ["*"],
+            classificationCeiling: "*",
+            traceId: "t",
+            deadlineAt: new Date().toISOString(),
+            budgets: {
+                maxWallTimeMs: 1,
+                maxSdkCalls: 1,
+                maxPages: 1,
+                maxRecords: 1,
+                maxBytes: 1,
+                maxEvidenceItems: 1,
+                maxRelationshipDepth: 0,
+                maxReasoningRounds: 1,
+                maxParallelCalls: 1,
+            },
+            flags: { bagsOnly: true, nexumExploreEnabled: false },
+        },
+        catalog: [{
+                id: "subjects.list",
+                version: "1",
+                description: "d",
+                surface: "subject",
+                operation: "subjects.list",
+                physicalContractVersion: "memorix-record/2",
+                identifiers: [],
+                relationships: [],
+                epistemicPlanes: [],
+                limits: {},
+                classification: "internal",
+                requiredPermissions: [],
+                mayBeMissing: true,
+                limitations: [],
+                prohibitedInferences: [],
+                owner: "t",
+            }],
+        profiles: [],
+    };
+}
+describe("AiDispatcherReasoner", () => {
+    it("repairs once then fails on invalid output", async () => {
+        const run = vi.fn()
+            .mockResolvedValueOnce({ text: "not-json" })
+            .mockResolvedValueOnce({ text: "{\"planId\":1}" });
+        const reasoner = new AiDispatcherReasoner({ provider: "openrouter", openrouter: { apiKey: "test" } }, { provider: "openrouter", run, executeStreamingChat: async function* () { }, compile: () => ({}) });
+        await expect(reasoner.createPlan(planningInput())).rejects.toBeInstanceOf(ScoperError);
+        expect(run).toHaveBeenCalledTimes(2);
+    });
+    it("parses a valid plan from dispatcher.run", async () => {
+        const plan = {
+            planId: "p1",
+            objective: "x",
+            profiles: ["general"],
+            steps: [],
+        };
+        const run = vi.fn().mockResolvedValue({ text: JSON.stringify(plan) });
+        const reasoner = new AiDispatcherReasoner({ provider: "openrouter", openrouter: { apiKey: "test" } }, { provider: "openrouter", run, executeStreamingChat: async function* () { }, compile: () => ({}) });
+        await expect(reasoner.createPlan(planningInput())).resolves.toEqual(plan);
+    });
+});
+//# sourceMappingURL=ai-dispatcher.test.js.map

package/dist/reasoner/ai-dispatcher.test.js.map

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

package/dist/reasoner/index.d.ts

@@ -0,0 +1,4 @@
+export type { ScoperReasoner, ReasonerInput } from "./types.js";
+export { ScriptedReasoner, type ScriptedReasonerOptions } from "./scripted.js";
+export { AiDispatcherReasoner, dispatcherOptionsFromEnv, type AiDispatcherReasonerOptions } from "./ai-dispatcher.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/reasoner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reasoner/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,KAAK,2BAA2B,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/reasoner/index.js

@@ -0,0 +1,3 @@
+export { ScriptedReasoner } from "./scripted.js";
+export { AiDispatcherReasoner, dispatcherOptionsFromEnv } from "./ai-dispatcher.js";
+//# sourceMappingURL=index.js.map

package/dist/reasoner/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reasoner/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAgC,MAAM,eAAe,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAoC,MAAM,oBAAoB,CAAC"}

package/dist/reasoner/scripted.d.ts

@@ -0,0 +1,14 @@
+import { type RetrievalPlan } from "@x12i/memorix-scoper-contracts";
+import type { ReasonerInput, ScoperReasoner } from "./types.js";
+export interface ScriptedReasonerOptions {
+    plans?: RetrievalPlan[];
+    factory?: (input: ReasonerInput) => RetrievalPlan | Promise<RetrievalPlan>;
+}
+/** Deterministic reasoner for tests and offline evaluation. */
+export declare class ScriptedReasoner implements ScoperReasoner {
+    private readonly options;
+    private index;
+    constructor(options?: ScriptedReasonerOptions);
+    proposePlan(input: ReasonerInput): Promise<RetrievalPlan>;
+}
+//# sourceMappingURL=scripted.d.ts.map

package/dist/reasoner/scripted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripted.d.ts","sourceRoot":"","sources":["../../src/reasoner/scripted.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC5E;AAED,+DAA+D;AAC/D,qBAAa,gBAAiB,YAAW,cAAc;IAEzC,OAAO,CAAC,QAAQ,CAAC,OAAO;IADpC,OAAO,CAAC,KAAK,CAAK;gBACW,OAAO,GAAE,uBAA4B;IAE5D,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CAYhE"}

package/dist/reasoner/scripted.js

@@ -0,0 +1,22 @@
+import { RetrievalPlanSchema, ScoperError, } from "@x12i/memorix-scoper-contracts";
+/** Deterministic reasoner for tests and offline evaluation. */
+export class ScriptedReasoner {
+    options;
+    index = 0;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async proposePlan(input) {
+        if (this.options.factory) {
+            return RetrievalPlanSchema.parse(await this.options.factory(input));
+        }
+        const plans = this.options.plans ?? [];
+        const plan = plans[Math.min(this.index, plans.length - 1)];
+        this.index += 1;
+        if (!plan) {
+            throw new ScoperError("REASONER_INVALID_PLAN", "ScriptedReasoner has no plans");
+        }
+        return RetrievalPlanSchema.parse(plan);
+    }
+}
+//# sourceMappingURL=scripted.js.map

package/dist/reasoner/scripted.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripted.js","sourceRoot":"","sources":["../../src/reasoner/scripted.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,WAAW,GAEZ,MAAM,gCAAgC,CAAC;AAQxC,+DAA+D;AAC/D,MAAM,OAAO,gBAAgB;IAEE;IADrB,KAAK,GAAG,CAAC,CAAC;IAClB,YAA6B,UAAmC,EAAE;QAArC,YAAO,GAAP,OAAO,CAA8B;IAAG,CAAC;IAEtE,KAAK,CAAC,WAAW,CAAC,KAAoB;QACpC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO,mBAAmB,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAChB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,WAAW,CAAC,uBAAuB,EAAE,+BAA+B,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/reasoner/types.d.ts

@@ -0,0 +1,17 @@
+import type { ScopeRequest, TrustedExecutionContext, ScoperProfile, RetrievalPlan, ScoperBudgets } from "@x12i/memorix-scoper-contracts";
+import type { ContextualSdk } from "@x12i/memorix-scoper-sdk";
+export interface ReasonerInput {
+    request: ScopeRequest;
+    context: TrustedExecutionContext;
+    profile: ScoperProfile;
+    budgets: ScoperBudgets;
+    catalog: ReturnType<ContextualSdk["catalog"]["describe"]>;
+    repairOf?: {
+        previousPlan: unknown;
+        error: string;
+    };
+}
+export interface ScoperReasoner {
+    proposePlan(input: ReasonerInput): Promise<RetrievalPlan>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/reasoner/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/reasoner/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,uBAAuB,EACvB,aAAa,EACb,aAAa,EACb,aAAa,EACd,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,uBAAuB,CAAC;IACjC,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAC1D,QAAQ,CAAC,EAAE;QAAE,YAAY,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3D"}

package/dist/reasoner/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/reasoner/types.js.map

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