@x12i/memorix-scoper-service 0.0.0-stage → 3.1.3

package/README.md

@@ -1,3 +1,30 @@
-# Temporary Holding Version
+# @x12i/memorix-scoper-service
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Scoper over HTTP. Reads Memorix through the Memorix client API as the caller, and writes `_markdown` to the Memorix service.
+
+## Run it alone
+
+```bash
+MEMORIX_SERVICE_URL=http://127.0.0.1:5100 npx memorix-scoper-service
+```
+
+Listens on `127.0.0.1:8787` (`HOST`, `PORT`). Uses `MEMORIX_CLIENT_API_URL` when set, otherwise the client API on port 5120, otherwise starts the optional `@x12i/memorix-client-api`. `SCOPER_SERVICE_ENV_FILE` names an env file to load into unset variables.
+
+## Mount it inside the client API
+
+```ts
+import { createScoperService, isScoperRoute } from "@x12i/memorix-scoper-service";
+
+const scoper = createScoperService({
+  env: {
+    MEMORIX_CLIENT_API_URL: "http://127.0.0.1:5120",
+    MEMORIX_SERVICE_URL: process.env.MEMORIX_SERVICE_URL,
+  },
+});
+
+if (isScoperRoute(req.method, req.url ?? "/")) return scoper.handler(req, res);
+```
+
+`createScoperService` does not open a port. The host serves `GET /api/v1/scoper`, `POST /api/v1/scoper/scope`, `POST /api/v1/scoper/subject-data`, and `GET|POST /api/v1/mcp/scoper` on its own port, and keeps its own `GET /health`. Callers send `x-memorix-org-id`, `x-memorix-agent-ids`, `x-memorix-caller`, and their `authorization`; Scoper sends that `authorization` on every read.
+
+Full reference: [operations](https://github.com/x12i/scoper-monorepo/blob/main/docs/operations.md).

package/dist/caller.d.ts

@@ -0,0 +1,26 @@
+import type { IncomingMessage } from "node:http";
+import type { TrustedExecutionContext } from "@x12i/memorix-scoper-contracts";
+/** Who is calling, from the headers the Memorix client API forwards. Never from the body. */
+export interface CallerCall {
+    context: TrustedExecutionContext;
+    /** The caller's own `authorization` header. Every read is sent with it. */
+    authorization?: string;
+}
+export type CallerResult = {
+    ok: true;
+    call: CallerCall;
+} | {
+    ok: false;
+    code: "SCOPE_INVALID";
+    message: string;
+};
+export declare function callerFromHeaders(req: IncomingMessage): CallerResult;
+export declare function stripUntrusted(body: unknown): unknown;
+/**
+ * Run one request with the caller's token in scope. The token stays out of the
+ * execution context, so it never reaches traces, evidence, or a model prompt.
+ */
+export declare function withCaller<T>(call: CallerCall, run: () => T): T;
+/** Headers for reads made inside `withCaller`. Empty outside a request. */
+export declare function forwardedHeaders(): Record<string, string>;
+//# sourceMappingURL=caller.d.ts.map

package/dist/caller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caller.d.ts","sourceRoot":"","sources":["../src/caller.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAE9E,6FAA6F;AAC7F,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,uBAAuB,CAAC;IACjC,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAC9B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAU1D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,eAAe,GAAG,YAAY,CA4BpE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAOrD;AAID;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAE/D;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGzD"}

package/dist/caller.js

@@ -0,0 +1,61 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { randomUUID } from "node:crypto";
+const UNTRUSTED = ["orgId", "agentIds", "caller", "token", "credentials", "memorixBaseUrl"];
+function headerValue(value) {
+    const raw = Array.isArray(value) ? value[0] : value;
+    const trimmed = raw?.trim();
+    return trimmed || undefined;
+}
+export function callerFromHeaders(req) {
+    const orgId = headerValue(req.headers["x-memorix-org-id"]);
+    const agentIds = (headerValue(req.headers["x-memorix-agent-ids"]) ?? "")
+        .split(",")
+        .map((id) => id.trim())
+        .filter(Boolean);
+    const caller = headerValue(req.headers["x-memorix-caller"]);
+    const missing = [
+        ...(orgId ? [] : ["x-memorix-org-id"]),
+        ...(agentIds.length ? [] : ["x-memorix-agent-ids"]),
+        ...(caller ? [] : ["x-memorix-caller"]),
+    ];
+    if (!orgId || !agentIds.length || !caller) {
+        return { ok: false, code: "SCOPE_INVALID", message: `missing header: ${missing.join(", ")}` };
+    }
+    const authorization = headerValue(req.headers.authorization);
+    return {
+        ok: true,
+        call: {
+            context: {
+                orgId,
+                agentIds,
+                caller,
+                traceId: headerValue(req.headers["x-trace-id"]) ?? randomUUID(),
+            },
+            ...(authorization ? { authorization } : {}),
+        },
+    };
+}
+export function stripUntrusted(body) {
+    if (!body || typeof body !== "object" || Array.isArray(body))
+        return body;
+    const out = {};
+    for (const [key, value] of Object.entries(body)) {
+        if (!UNTRUSTED.includes(key))
+            out[key] = value;
+    }
+    return out;
+}
+const forwarded = new AsyncLocalStorage();
+/**
+ * Run one request with the caller's token in scope. The token stays out of the
+ * execution context, so it never reaches traces, evidence, or a model prompt.
+ */
+export function withCaller(call, run) {
+    return forwarded.run({ authorization: call.authorization }, run);
+}
+/** Headers for reads made inside `withCaller`. Empty outside a request. */
+export function forwardedHeaders() {
+    const authorization = forwarded.getStore()?.authorization;
+    return authorization ? { authorization } : {};
+}
+//# sourceMappingURL=caller.js.map

package/dist/caller.js.map

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

package/dist/client-api.d.ts

@@ -0,0 +1,69 @@
+/** Default Memorix client API. Same host, port 5120. */
+export declare const DEFAULT_CLIENT_API_URL = "http://127.0.0.1:5120";
+/** `GET /health` reports this `service` value. */
+export declare const CLIENT_API_SERVICE_NAME = "@x12i/memorix-client-api";
+export type ClientApiLocation = {
+    kind: "configured" | "discovered";
+    url: string;
+} | {
+    kind: "start";
+    url: string;
+    port: number;
+};
+export interface ClientApiProcess {
+    killed: boolean;
+    kill(signal?: NodeJS.Signals | number): boolean;
+    once(event: "exit", listener: (code: number | null) => void): unknown;
+}
+export interface DiscoverClientApiOptions {
+    env?: NodeJS.ProcessEnv;
+    /** Probed when `MEMORIX_CLIENT_API_URL` is unset. Default `http://127.0.0.1:5120`. */
+    defaultUrl?: string;
+    fetchImpl?: typeof fetch;
+}
+export interface SpawnClientApiOptions {
+    port: number;
+    /** Scoper base URL the API probes and then forwards Scoper routes to. */
+    scoperUrl: string;
+    memorixServiceUrl: string;
+    env?: NodeJS.ProcessEnv;
+    /** Test hook. Default is the installed package's `dist/cli.js`. */
+    cliPath?: string;
+    spawnImpl?: (command: string, args: readonly string[], options: {
+        env: NodeJS.ProcessEnv;
+        stdio: "inherit";
+        windowsHide: true;
+        cwd: string;
+    }) => ClientApiProcess;
+}
+/** Trimmed http(s) URL without a trailing slash. */
+export declare function httpBaseUrl(raw: string | undefined, name: string): string;
+export declare function optionalHttpBaseUrl(raw: string | undefined, name: string): string | undefined;
+/**
+ * Where reads go.
+ * `MEMORIX_CLIENT_API_URL` wins.
+ * Otherwise the client API already listening on port 5120.
+ * Otherwise a URL this process can start.
+ */
+export declare function discoverClientApi(options?: DiscoverClientApiOptions): Promise<ClientApiLocation>;
+/** Poll `/health` until it is this client API, or the process has exited. */
+export declare function waitForClientApi(url: string, options?: {
+    fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+    intervalMs?: number;
+    exited?: {
+        done: boolean;
+        code: number | null;
+    };
+}): Promise<void>;
+/**
+ * `dist/cli.js` beside the package entry. The package has no bin field.
+ * `exports` is import-only, so resolution tries `import.meta.resolve` and then walks `node_modules`.
+ */
+export declare function clientApiCliPath(): string;
+/**
+ * Start the installed client API.
+ * Scoper must already be listening: the API probes `SCOPER_URL` `/health` before it accepts calls.
+ */
+export declare function spawnClientApi(options: SpawnClientApiOptions): ClientApiProcess;
+//# sourceMappingURL=client-api.d.ts.map

package/dist/client-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-api.d.ts","sourceRoot":"","sources":["../src/client-api.ts"],"names":[],"mappings":"AAMA,wDAAwD;AACxD,eAAO,MAAM,sBAAsB,0BAA0B,CAAC;AAE9D,kDAAkD;AAClD,eAAO,MAAM,uBAAuB,6BAA6B,CAAC;AAIlE,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,YAAY,GAAG,YAAY,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IAChD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC;CACvE;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,CACV,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;QAAC,KAAK,EAAE,SAAS,CAAC;QAAC,WAAW,EAAE,IAAI,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAClF,gBAAgB,CAAC;CACvB;AAUD,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAazE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG7F;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqB1G;AAED,6EAA6E;AAC7E,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAC5C,GACL,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAmBzC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,gBAAgB,CAiB/E"}

package/dist/client-api.js

@@ -0,0 +1,202 @@
+import { spawn } from "node:child_process";
+import { createServer } from "node:http";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+/** Default Memorix client API. Same host, port 5120. */
+export const DEFAULT_CLIENT_API_URL = "http://127.0.0.1:5120";
+/** `GET /health` reports this `service` value. */
+export const CLIENT_API_SERVICE_NAME = "@x12i/memorix-client-api";
+const PROBE_TIMEOUT_MS = 1500;
+/** Trimmed http(s) URL without a trailing slash. */
+export function httpBaseUrl(raw, name) {
+    const trimmed = raw?.trim() ?? "";
+    if (!trimmed)
+        throw new Error(`${name} is required`);
+    let url;
+    try {
+        url = new URL(trimmed);
+    }
+    catch {
+        throw new Error(`${name} is not a URL: ${trimmed}`);
+    }
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        throw new Error(`${name} must be http or https: ${trimmed}`);
+    }
+    return trimmed.replace(/\/+$/, "");
+}
+export function optionalHttpBaseUrl(raw, name) {
+    if (!raw?.trim())
+        return undefined;
+    return httpBaseUrl(raw, name);
+}
+/**
+ * Where reads go.
+ * `MEMORIX_CLIENT_API_URL` wins.
+ * Otherwise the client API already listening on port 5120.
+ * Otherwise a URL this process can start.
+ */
+export async function discoverClientApi(options = {}) {
+    const env = options.env ?? process.env;
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const explicit = optionalHttpBaseUrl(env.MEMORIX_CLIENT_API_URL, "MEMORIX_CLIENT_API_URL");
+    if (explicit) {
+        const probe = await probeClientApi(explicit, fetchImpl);
+        if (probe.mismatch) {
+            throw new Error(`MEMORIX_CLIENT_API_URL ${explicit} answered, and it is not ${CLIENT_API_SERVICE_NAME} (${probe.reason})`);
+        }
+        return { kind: "configured", url: explicit };
+    }
+    const fallback = options.defaultUrl?.replace(/\/+$/, "") || DEFAULT_CLIENT_API_URL;
+    const probe = await probeClientApi(fallback, fetchImpl);
+    if (probe.ok)
+        return { kind: "discovered", url: probe.url };
+    const preferred = portOf(probe.url);
+    const port = await choosePort(preferred);
+    return { kind: "start", port, url: `http://127.0.0.1:${port}` };
+}
+/** Poll `/health` until it is this client API, or the process has exited. */
+export async function waitForClientApi(url, options = {}) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const timeoutMs = options.timeoutMs ?? 90_000;
+    const intervalMs = options.intervalMs ?? 250;
+    const deadline = Date.now() + timeoutMs;
+    let reason = "health did not answer";
+    while (Date.now() < deadline) {
+        if (options.exited?.done) {
+            throw new Error(`The Memorix client API process exited (${options.exited.code ?? "signal"}) before ${url} was ready`);
+        }
+        const probe = await probeClientApi(url, fetchImpl);
+        if (probe.ok)
+            return;
+        reason = probe.reason;
+        await sleep(intervalMs);
+    }
+    throw new Error(`Memorix client API at ${url} did not become ready within ${timeoutMs}ms (${reason})`);
+}
+/**
+ * `dist/cli.js` beside the package entry. The package has no bin field.
+ * `exports` is import-only, so resolution tries `import.meta.resolve` and then walks `node_modules`.
+ */
+export function clientApiCliPath() {
+    try {
+        const entry = fileURLToPath(import.meta.resolve("@x12i/memorix-client-api"));
+        const beside = join(dirname(entry), "cli.js");
+        if (existsSync(beside))
+            return beside;
+    }
+    catch {
+        // Some loaders cannot resolve this package's import-only exports.
+    }
+    let dir = dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 6; i++) {
+        const cli = join(dir, "node_modules", "@x12i", "memorix-client-api", "dist", "cli.js");
+        if (existsSync(cli))
+            return cli;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    throw new Error(`@x12i/memorix-client-api is not installed, so Scoper cannot start the client API. Set MEMORIX_CLIENT_API_URL or install the package.`);
+}
+/**
+ * Start the installed client API.
+ * Scoper must already be listening: the API probes `SCOPER_URL` `/health` before it accepts calls.
+ */
+export function spawnClientApi(options) {
+    const cli = options.cliPath ?? clientApiCliPath();
+    const env = {
+        ...options.env,
+        HOST: "127.0.0.1",
+        MEMORIX_SERVICE_URL: options.memorixServiceUrl,
+        MEMORIX_CLIENT_API_PORT: String(options.port),
+        SCOPER_MODE: "external",
+        SCOPER_URL: options.scoperUrl,
+    };
+    const spawnImpl = options.spawnImpl ?? defaultSpawn;
+    return spawnImpl(process.execPath, [cli], {
+        env,
+        stdio: "inherit",
+        windowsHide: true,
+        cwd: process.cwd(),
+    });
+}
+function defaultSpawn(command, args, options) {
+    return spawn(command, args, options);
+}
+async function probeClientApi(url, fetchImpl) {
+    const base = url.replace(/\/+$/, "");
+    try {
+        const response = await fetchImpl(`${base}/health`, { signal: AbortSignal.timeout(PROBE_TIMEOUT_MS) });
+        const text = await response.text();
+        let body = null;
+        if (text) {
+            try {
+                body = JSON.parse(text);
+            }
+            catch {
+                body = null;
+            }
+        }
+        if (response.ok && isClientApiHealth(body)) {
+            return { ok: true, mismatch: false, reason: "", url: base };
+        }
+        const service = record(body)?.service;
+        const named = typeof service === "string" ? service : "";
+        return {
+            ok: false,
+            mismatch: response.ok && body !== null && !isClientApiHealth(body),
+            reason: named ? `service is ${named}` : `health HTTP ${response.status}`,
+            url: base,
+        };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            mismatch: false,
+            reason: err instanceof Error ? err.message : String(err),
+            url: base,
+        };
+    }
+}
+function isClientApiHealth(body) {
+    const health = record(body);
+    return health?.ok === true && health.service === CLIENT_API_SERVICE_NAME;
+}
+function record(value) {
+    if (value && typeof value === "object" && !Array.isArray(value))
+        return value;
+    return undefined;
+}
+function portOf(url) {
+    const parsed = new URL(url);
+    if (parsed.port)
+        return Number(parsed.port);
+    return parsed.protocol === "https:" ? 443 : 80;
+}
+/** Prefer `preferred` when it is free. Otherwise any free localhost port. */
+async function choosePort(preferred) {
+    const same = await listenPort(preferred);
+    if (same)
+        return same;
+    const any = await listenPort(0);
+    if (!any)
+        throw new Error("No free TCP port for the Memorix client API");
+    return any;
+}
+function listenPort(port) {
+    return new Promise((resolve) => {
+        const server = createServer();
+        server.once("error", () => resolve(undefined));
+        server.listen(port, "127.0.0.1", () => {
+            const addr = server.address();
+            const chosen = addr && typeof addr === "object" ? addr.port : undefined;
+            server.close(() => resolve(chosen));
+        });
+    });
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=client-api.js.map

package/dist/client-api.js.map

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

package/dist/create-service.d.ts

@@ -0,0 +1,146 @@
+import { type IncomingMessage, type ServerResponse } from "node:http";
+import type { CreateScoperOptions } from "@x12i/memorix-scoper";
+import { type ServiceEnv } from "./scoper-host.js";
+export { resolveReasonerKind, readServiceEnv, type ServiceEnv } from "./scoper-host.js";
+declare const SCOPER_PACKAGE = "@x12i/memorix-scoper";
+export interface ServiceOptions {
+    port?: number;
+    host?: string;
+    /** Read for the client API URL, the Memorix URL, the reasoner, and saved functions. Default `process.env`. */
+    env?: NodeJS.ProcessEnv;
+    /** Merged over the Scoper options built from env. */
+    scoperOptions?: Partial<CreateScoperOptions>;
+    /** Used for reads and the Memorix write. Default global `fetch`. */
+    fetchImpl?: typeof fetch;
+}
+export interface ScoperServiceInfo {
+    package: typeof SCOPER_PACKAGE;
+    version: string;
+    sdk: string;
+    functionsPackage: string;
+    reasoner: ServiceEnv["reasoner"];
+    functions: boolean;
+    reads: {
+        via: "memorix-client-api";
+        baseUrl: string;
+    };
+    writes: {
+        via: "memorix-service";
+        baseUrl: string;
+    };
+    aligned: {
+        memorixClientApiClient: string;
+        memorixClient: string;
+    };
+}
+/**
+ * True for the routes a host should pass to `handler`. `GET /health` is not one:
+ * a host that mounts Scoper keeps its own health and can report `info` there.
+ */
+export declare function isScoperRoute(method: string | undefined, path: string): boolean;
+export declare function createScoperService(options?: ServiceOptions): {
+    server: import("http").Server<typeof IncomingMessage, typeof ServerResponse>;
+    handler: (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+    scoper: {
+        scope: (request: Parameters<typeof import("@x12i/memorix-scoper").scope>[0], context: Parameters<typeof import("@x12i/memorix-scoper").scope>[1], call?: Parameters<typeof import("@x12i/memorix-scoper").scope>[3]) => Promise<{
+            items: {
+                id: string;
+                ref: {
+                    kind: "subject";
+                    orgId: string;
+                    objectType: string;
+                    contentType: string;
+                    recordId: string;
+                    revision?: string | number | undefined;
+                } | {
+                    kind: "estate-bag";
+                    orgId: string;
+                    sessionId: string;
+                    bagId: string;
+                    path?: string | undefined;
+                } | {
+                    kind: "knowledge-explore";
+                    orgId: string;
+                    exploreQueryId: string;
+                    nodeIds?: string[] | undefined;
+                };
+                summary: string;
+                epistemic: "OBSERVED" | "INFERRED" | "POLICY_CANDIDATE" | "REACHABLE" | "UNKNOWN" | "CONFLICTING";
+                confidence?: number | undefined;
+                payload?: unknown;
+                tags?: string[] | undefined;
+            }[];
+            conflicts: {
+                message: string;
+                id: string;
+                evidenceIds: string[];
+                severity: "low" | "medium" | "high";
+            }[];
+            unknowns: {
+                message: string;
+                id: string;
+                relatedEvidenceIds?: string[] | undefined;
+            }[];
+            warnings: {
+                code: string;
+                message: string;
+                details?: unknown;
+            }[];
+            continuations: {
+                kind: "follow-up-question" | "estate-session" | "explore" | "manual";
+                message: string;
+                payload?: unknown;
+            }[];
+            answer?: string | undefined;
+            budgetsUsed?: {
+                subjects?: number | undefined;
+                evidenceItems?: number | undefined;
+                parallelCalls?: number | undefined;
+                tokens?: number | undefined;
+                wallClockMs?: number | undefined;
+            } | undefined;
+        }>;
+        scopeByIntent: (request: Parameters<typeof import("@x12i/memorix-scoper").scopeByIntent>[0], context: Parameters<typeof import("@x12i/memorix-scoper").scopeByIntent>[1]) => Promise<{
+            anchor: {
+                contentTypes: {
+                    id: string;
+                    properties: string[];
+                }[];
+                objectType: string;
+                recordIds: string[];
+            };
+            intent: string;
+            associations: {
+                contentTypes: {
+                    id: string;
+                    properties: string[];
+                }[];
+                objectType: string;
+                field: string;
+                recordIds?: string[] | undefined;
+            }[];
+            warnings?: string[] | undefined;
+        }>;
+        listIntents: () => {
+            id: string;
+            title: string;
+            contentTypes: string[];
+            objectType: string;
+            relations: {
+                contentTypes: string[];
+                objectType: string;
+                field: string;
+                sourceContentType?: string | undefined;
+            }[];
+        }[];
+        deps: import("@x12i/memorix-scoper").ScoperDependencies;
+    };
+    info: ScoperServiceInfo;
+    listen(portOverride?: number): Promise<{
+        port: number;
+        host: string;
+    }>;
+    close(): Promise<void>;
+};
+export type ScoperService = ReturnType<typeof createScoperService>;
+//# sourceMappingURL=create-service.d.ts.map

package/dist/create-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-service.d.ts","sourceRoot":"","sources":["../src/create-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAEpF,OAAO,KAAK,EAAE,mBAAmB,EAAU,MAAM,sBAAsB,CAAC;AAKxE,OAAO,EAA+B,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGhF,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAExF,QAAA,MAAM,cAAc,yBAAyB,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8GAA8G;IAC9G,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,qDAAqD;IACrD,aAAa,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC7C,oEAAoE;IACpE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,cAAc,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE;QAAE,GAAG,EAAE,oBAAoB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,MAAM,EAAE;QAAE,GAAG,EAAE,iBAAiB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,OAAO,EAAE;QAAE,sBAAsB,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CACpE;AAqCD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAG/E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,cAAmB;;mBA8BlC,eAAe,OAAO,cAAc,KAAG,OAAO,CAAC,IAAI,CAAC;;8JAjE3E,CAAC;;;;;;;;;4BAQkB,CAAC;;;;;;wBAKzB,CADG;;;;;2BAML,CAAA;;;;0BAIU,CAAA;uBACO,CAAC;oBAIjB,CAAD;;;;;;;;;;;kCAI2D,CAAC;;;;;uBAIf,CAAA;;;;;uBAKrB,CAAC;;kBAAsC,CAAC;uBAAyC,CAAC;wBACtG,CAAH;6BAEkC,CAAC;6BACjB,CAAC;sBAEb,CAAC;2BACmC,CAAC;;;;;;;;;;;;;;;;;;;;yBAmBxC,CADiF;;oBACjC,CAAC;;;;;;;;;;;iCAQ5B,CAAC;;;;;;0BAoEA,MAAM;cAGC,MAAM;cAAQ,MAAM;;;EAapD;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC"}