@x12i/memorix-scoper 2.3.0 → 3.0.0

package/dist/selection/adapter.js

@@ -0,0 +1,57 @@
+import { createDecisionDispatcher, resolveDefaultDecisionSku, } from "@x12i/decision-dispatcher";
+import { ScoperError } from "@x12i/memorix-scoper-contracts";
+/**
+ * Inputs for one step. `model` is the pagx spec, not the SKU, and is left unset.
+ * `@x12i/decision-dispatcher@1.0.0` rejects a missing spec. This call stays without
+ * one until a dispatcher build fills that default. `sku.model` is not copied here.
+ */
+export function decisionRequestFrom(input) {
+    return {
+        inputs: {
+            step: input.step,
+            intent: input.intent,
+            objectType: input.objectType,
+            ...(input.contentType ? { contentType: input.contentType } : {}),
+            ...(input.field ? { field: input.field } : {}),
+            candidates: input.candidates,
+            ...(input.values !== undefined ? { values: input.values } : {}),
+        },
+        context: `${input.intent.title} (${input.intent.objectType})`,
+    };
+}
+/**
+ * In-process decision dispatcher. Shares the host's ai-dispatcher.
+ * The judgment SKU is `resolveDefaultDecisionSku()` (live registry, else the
+ * JSON shipped in decision-models). No profile pin, no role pin, no registry env.
+ */
+export async function createScopeDecider(dispatcher) {
+    const sku = await resolveDefaultDecisionSku();
+    const decisions = createDecisionDispatcher({
+        dispatcher,
+        cache: false,
+        pagx: { autoInstall: false },
+        defaults: { provider: sku.provider, model: sku.model },
+    });
+    return {
+        async decide(input) {
+            const request = decisionRequestFrom(input);
+            try {
+                const answer = await decisions.decide(request);
+                const decision = answer.decision && typeof answer.decision === "object" && !Array.isArray(answer.decision)
+                    ? answer.decision
+                    : {};
+                return { decision, value: answer.value };
+            }
+            catch (err) {
+                if (err instanceof ScoperError)
+                    throw err;
+                const code = err && typeof err === "object" && "code" in err ? String(err.code) : "";
+                const message = err instanceof Error ? err.message : String(err);
+                throw new ScoperError("UPSTREAM_UNAVAILABLE", message, {
+                    ...(code ? { details: { code } } : {}),
+                });
+            }
+        },
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/selection/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/selection/adapter.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wBAAwB,EACxB,yBAAyB,GAE1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAG7D;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAyB;IAI3D,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChE;QACD,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,CAAC,UAAU,GAAG;KAC9D,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,UAAwB;IAC/D,MAAM,GAAG,GAAG,MAAM,yBAAyB,EAAE,CAAC;IAC9C,MAAM,SAAS,GAAG,wBAAwB,CAAC;QACzC,UAAU;QACV,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE;QAC5B,QAAQ,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE;KACvD,CAAC,CAAC;IACH,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,KAAK;YAChB,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,OAA0B,CAAC,CAAC;gBAClE,MAAM,QAAQ,GACZ,MAAM,CAAC,QAAQ,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;oBACvF,CAAC,CAAC,MAAM,CAAC,QAAQ;oBACjB,CAAC,CAAC,EAAE,CAAC;gBACT,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;YAC3C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,WAAW;oBAAE,MAAM,GAAG,CAAC;gBAC1C,MAAM,IAAI,GACR,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,CAAE,GAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjG,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,MAAM,IAAI,WAAW,CAAC,sBAAsB,EAAE,OAAO,EAAE;oBACrD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACvC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/selection/cache.d.ts

@@ -0,0 +1,72 @@
+import type { ScopeSelection } from "@x12i/memorix-scoper-contracts";
+import type { ScopeIntent } from "@x12i/memorix-scoper-contracts";
+export declare const DEFAULT_ADDRESS_TTL_MS: number;
+export declare const DEFAULT_RECORD_TTL_MS: number;
+export declare const DEFAULT_TEXT_TTL_MS: number;
+export interface ShownRevision {
+    /** `*` is the record's root revision. Any other value is a content type that was shown. */
+    contentType: string;
+    revision: string | number | null;
+}
+export interface AddressCacheEntry {
+    selection: ScopeSelection;
+    fingerprint: string;
+    objectTypeIds: string[];
+}
+export interface RecordCacheEntry {
+    selection: ScopeSelection;
+    revisions: ShownRevision[];
+}
+export interface TextCacheEntry {
+    selection: ScopeSelection;
+    fingerprint: string;
+    objectTypeIds: string[];
+    /** Leading content type the first-tier ids were listed from. */
+    contentType?: string;
+    revisions: Array<{
+        recordId: string;
+        revision: string | number | null;
+    }>;
+}
+export interface SelectionCacheConfig {
+    addressTtlMs?: number;
+    recordTtlMs?: number;
+    textTtlMs?: number;
+    now?: () => number;
+}
+export interface SelectionCaches {
+    address: TtlMap<AddressCacheEntry>;
+    record: TtlMap<RecordCacheEntry>;
+    text: TtlMap<TextCacheEntry>;
+}
+export declare class TtlMap<T> {
+    private readonly ttlMs;
+    private readonly now;
+    private readonly entries;
+    constructor(ttlMs: number, now: () => number);
+    get(key: string): T | undefined;
+    set(key: string, value: T): void;
+}
+/** Three maps. A hit does not call the decision dispatcher. `redo` skips the read. */
+export declare function createSelectionCaches(config?: SelectionCacheConfig): SelectionCaches;
+export declare function addressCacheKey(input: {
+    orgId: string;
+    agentIds: readonly string[];
+    intent: ScopeIntent;
+    objectType: string;
+}): string;
+export declare function recordCacheKey(input: {
+    orgId: string;
+    agentIds: readonly string[];
+    intent: ScopeIntent;
+    objectType: string;
+    recordId: string;
+}): string;
+export declare function textCacheKey(input: {
+    orgId: string;
+    agentIds: readonly string[];
+    intent: ScopeIntent;
+    objectType: string;
+    text: string;
+}): string;
+//# sourceMappingURL=cache.d.ts.map

package/dist/selection/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/selection/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAGlE,eAAO,MAAM,sBAAsB,QAAsB,CAAC;AAC1D,eAAO,MAAM,qBAAqB,QAAiB,CAAC;AACpD,eAAO,MAAM,mBAAmB,QAAiB,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,2FAA2F;IAC3F,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,cAAc,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,cAAc,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAC1E;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;CAC9B;AAED,qBAAa,MAAM,CAAC,CAAC;IAIjB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAJtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsD;gBAG3D,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,MAAM;IAGpC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAU/B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;CAGjC;AAUD,sFAAsF;AACtF,wBAAgB,qBAAqB,CAAC,MAAM,GAAE,oBAAyB,GAAG,eAAe,CAgBxF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAOT;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAET;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAET"}

package/dist/selection/cache.js

@@ -0,0 +1,59 @@
+import { stableHash } from "@x12i/memorix-scoper-sdk";
+export const DEFAULT_ADDRESS_TTL_MS = 24 * 60 * 60 * 1000;
+export const DEFAULT_RECORD_TTL_MS = 60 * 60 * 1000;
+export const DEFAULT_TEXT_TTL_MS = 10 * 60 * 1000;
+export class TtlMap {
+    ttlMs;
+    now;
+    entries = new Map();
+    constructor(ttlMs, now) {
+        this.ttlMs = ttlMs;
+        this.now = now;
+    }
+    get(key) {
+        const hit = this.entries.get(key);
+        if (!hit)
+            return undefined;
+        if (hit.expiresAt <= this.now()) {
+            this.entries.delete(key);
+            return undefined;
+        }
+        return hit.value;
+    }
+    set(key, value) {
+        this.entries.set(key, { value, expiresAt: this.now() + this.ttlMs });
+    }
+}
+function ttlFromEnv(name, fallback, override) {
+    if (override !== undefined && Number.isFinite(override) && override >= 0)
+        return override;
+    const raw = process.env[name];
+    if (!raw)
+        return fallback;
+    const parsed = Number(raw);
+    return Number.isFinite(parsed) && parsed >= 0 ? parsed : fallback;
+}
+/** Three maps. A hit does not call the decision dispatcher. `redo` skips the read. */
+export function createSelectionCaches(config = {}) {
+    const now = config.now ?? (() => Date.now());
+    return {
+        address: new TtlMap(ttlFromEnv("SCOPER_SCOPE_ADDRESS_TTL_MS", DEFAULT_ADDRESS_TTL_MS, config.addressTtlMs), now),
+        record: new TtlMap(ttlFromEnv("SCOPER_SCOPE_RECORD_TTL_MS", DEFAULT_RECORD_TTL_MS, config.recordTtlMs), now),
+        text: new TtlMap(ttlFromEnv("SCOPER_SCOPE_TEXT_TTL_MS", DEFAULT_TEXT_TTL_MS, config.textTtlMs), now),
+    };
+}
+export function addressCacheKey(input) {
+    return [
+        input.orgId,
+        [...input.agentIds].sort().join(","),
+        stableHash(input.intent),
+        input.objectType,
+    ].join("\n");
+}
+export function recordCacheKey(input) {
+    return `${addressCacheKey(input)}\n${input.recordId}`;
+}
+export function textCacheKey(input) {
+    return `${addressCacheKey(input)}\n${stableHash(input.text)}`;
+}
+//# sourceMappingURL=cache.js.map

package/dist/selection/cache.js.map

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

package/dist/selection/ids.d.ts

@@ -0,0 +1,4 @@
+/** Same cap as connected source refs on a subject-data read. */
+export declare const MAX_RELATION_IDS = 16;
+export declare function relationRecordIds(value: unknown): string[];
+//# sourceMappingURL=ids.d.ts.map

package/dist/selection/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/selection/ids.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAoB1D"}

package/dist/selection/ids.js

@@ -0,0 +1,29 @@
+/** Same cap as connected source refs on a subject-data read. */
+export const MAX_RELATION_IDS = 16;
+export function relationRecordIds(value) {
+    const ids = [];
+    const push = (item) => {
+        if (ids.length >= MAX_RELATION_IDS)
+            return;
+        let raw = item;
+        if (item && typeof item === "object" && !Array.isArray(item)) {
+            const record = item;
+            raw = record.recordId ?? record.id;
+        }
+        if (typeof raw !== "string")
+            return;
+        const id = raw.trim();
+        if (!id || ids.includes(id))
+            return;
+        ids.push(id);
+    };
+    if (Array.isArray(value)) {
+        for (const item of value)
+            push(item);
+    }
+    else {
+        push(value);
+    }
+    return ids;
+}
+//# sourceMappingURL=ids.js.map

package/dist/selection/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/selection/ids.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAEnC,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,CAAC,IAAa,EAAE,EAAE;QAC7B,IAAI,GAAG,CAAC,MAAM,IAAI,gBAAgB;YAAE,OAAO;QAC3C,IAAI,GAAG,GAAY,IAAI,CAAC;QACxB,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7D,MAAM,MAAM,GAAG,IAA+B,CAAC;YAC/C,GAAG,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,EAAE,CAAC;QACrC,CAAC;QACD,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO;QACpC,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,EAAE,IAAI,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,OAAO;QACpC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,CAAC,CAAC;IACF,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,KAAK,CAAC,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/selection/pick.d.ts

@@ -0,0 +1,11 @@
+import type { ScopeDecider } from "./types.js";
+/** Ids a candidate list offers, in candidate order. */
+export declare function candidateIds(candidates: unknown): string[];
+/**
+ * Keep ids that were candidates. Anything else is dropped and named in `warnings`.
+ * Order follows the decision. `answer.value` is not read.
+ */
+export declare function keepPicked(decision: Record<string, unknown> | undefined, allowed: readonly string[], warnings: string[], step: string): string[];
+/** A decider that keeps every candidate. For tests and hosts that want the whole menu. */
+export declare function selectAllDecider(): ScopeDecider;
+//# sourceMappingURL=pick.d.ts.map

package/dist/selection/pick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick.d.ts","sourceRoot":"","sources":["../../src/selection/pick.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,YAAY,CAAC;AA0BnE,uDAAuD;AACvD,wBAAgB,YAAY,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE,CAQ1D;AAgBD;;;GAGG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC7C,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,QAAQ,EAAE,MAAM,EAAE,EAClB,IAAI,EAAE,MAAM,GACX,MAAM,EAAE,CAWV;AAED,0FAA0F;AAC1F,wBAAgB,gBAAgB,IAAI,YAAY,CAM/C"}

package/dist/selection/pick.js

@@ -0,0 +1,77 @@
+const DECISION_LIST_KEYS = [
+    "selected",
+    "contentTypes",
+    "properties",
+    "fields",
+    "recordIds",
+    "ids",
+    "paths",
+];
+function idOf(item) {
+    if (typeof item === "string") {
+        const id = item.trim();
+        return id || null;
+    }
+    if (!item || typeof item !== "object" || Array.isArray(item))
+        return null;
+    const record = item;
+    for (const key of ["id", "path", "field", "recordId"]) {
+        const value = record[key];
+        if (typeof value === "string" && value.trim())
+            return value.trim();
+    }
+    return null;
+}
+/** Ids a candidate list offers, in candidate order. */
+export function candidateIds(candidates) {
+    if (!Array.isArray(candidates))
+        return [];
+    const ids = [];
+    for (const item of candidates) {
+        const id = idOf(item);
+        if (id && !ids.includes(id))
+            ids.push(id);
+    }
+    return ids;
+}
+function stringsFromDecision(decision) {
+    for (const key of DECISION_LIST_KEYS) {
+        const value = decision[key];
+        if (!Array.isArray(value))
+            continue;
+        const ids = [];
+        for (const item of value) {
+            const id = idOf(item);
+            if (id && !ids.includes(id))
+                ids.push(id);
+        }
+        return ids;
+    }
+    return [];
+}
+/**
+ * Keep ids that were candidates. Anything else is dropped and named in `warnings`.
+ * Order follows the decision. `answer.value` is not read.
+ */
+export function keepPicked(decision, allowed, warnings, step) {
+    const allow = new Set(allowed);
+    const kept = [];
+    for (const id of stringsFromDecision(decision ?? {})) {
+        if (!allow.has(id)) {
+            warnings.push(`${step}: dropped "${id}" because it is not a candidate.`);
+            continue;
+        }
+        if (!kept.includes(id))
+            kept.push(id);
+    }
+    return kept;
+}
+/** A decider that keeps every candidate. For tests and hosts that want the whole menu. */
+export function selectAllDecider() {
+    return {
+        async decide(input) {
+            return { decision: { selected: candidateIds(input.candidates) } };
+        },
+    };
+}
+//# sourceMappingURL=pick.js.map

package/dist/selection/pick.js.map

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

package/dist/selection/run.d.ts

@@ -0,0 +1,12 @@
+import { type IntentScopeRequest, type ScopeIntent, type ScopeSelection, type TrustedExecutionContext } from "@x12i/memorix-scoper-contracts";
+import type { MemorixScoperClient } from "@x12i/memorix-scoper-sdk";
+import { type SelectionCaches } from "./cache.js";
+import type { ScopeDecider } from "./types.js";
+export interface ScopeSelectionDeps {
+    sdk: MemorixScoperClient;
+    intents?: Record<string, ScopeIntent>;
+    decisions: ScopeDecider;
+    caches: SelectionCaches;
+}
+export declare function runScopeSelection(request: IntentScopeRequest, context: TrustedExecutionContext, deps: ScopeSelectionDeps): Promise<ScopeSelection>;
+//# sourceMappingURL=run.d.ts.map

package/dist/selection/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/selection/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC7B,MAAM,gCAAgC,CAAC;AAUxC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,OAAO,EAML,KAAK,eAAe,EAGrB,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,YAAY,EAA2C,MAAM,YAAY,CAAC;AAIxF,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,mBAAmB,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,SAAS,EAAE,YAAY,CAAC;IACxB,MAAM,EAAE,eAAe,CAAC;CACzB;AAuND,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,uBAAuB,EAChC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,cAAc,CAAC,CA0SzB"}