@medicine-wheel/memory 0.16.0

package/README.md

@@ -0,0 +1,76 @@
+# @medicine-wheel/memory
+
+Asking the wheel's memory, whoever keeps it. The wheel records ceremonies, turns and diary entries. A memory provider (Honcho today, through `@medicine-wheel/honcho`) receives them and reasons over them. A caller asks the **wheel**, never the provider: it names a scope, the wheel turns it into the ceremonies it covers, and every provider is kept inside that reach. Every source in an answer is a wheel record, or is marked as coming from outside the wheel.
+
+This package holds what does not depend on the provider. It has no dependencies.
+
+## The contract
+
+```ts
+interface MemoryScope {            // every field adds ceremonies; the reach is their union
+  ceremonies?: string | string[];
+  subject_id?: string | string[];  // ceremonies held about a node: a review, a PDE (pde:<uuid>)
+  circle_id?: string | string[];
+  episode_path?: string | string[];
+  participant?: string;            // where this person was seated: participant, circle member, facilitator
+  exclude_ceremonies?: string[];   // removed last, e.g. a PDE's own ceremony
+}
+
+interface MemoryAnswer {
+  provider: string;                // 'honcho', or 'wheel' when only the wheel's own records answered
+  mode: 'dialectic' | 'search' | 'matched' | 'empty';
+  answer?: string;                 // dialectic only
+  sources: MemorySource[];
+  reach: { scope; ceremonies: string[]; episodes: string[] };
+  note?: string;                   // why a fallback answered
+}
+
+interface MemorySource {
+  provider: string;                // who produced this source
+  wheel_kind: string;              // beat | diary | ceremony | message (outside the wheel)
+  wheel_id: string;
+  ceremony_id?: string;
+  speaker?: string;                // a wheel id
+  speaker_name?: string;
+  excerpt: string;                 // person ids replaced with names
+  at?: string;
+  outside_wheel?: boolean;
+}
+```
+
+A scope with no field reaches nothing. The whole wheel is never the default.
+
+| mode | meaning |
+| --- | --- |
+| `dialectic` | a provider reasoned over the reach |
+| `search` | a provider returned the closest records without reasoning, because it cannot keep its reasoning inside a reach or was not asked to reason |
+| `matched` | no provider answered, and the wheel matched its own records on their words |
+| `empty` | the reach holds nothing, and nothing was asked |
+
+## Using it
+
+A wheel server builds one memory from its store and its providers:
+
+```ts
+import { createMemory } from '@medicine-wheel/memory';
+import { createHonchoClient, honchoFromEnv, honchoMemoryProvider } from '@medicine-wheel/honcho';
+
+const memory = createMemory({
+  wheel,                                            // MemoryWheel: ceremonies(), seats(), records(reach), names(ids)
+  providers: [honchoMemoryProvider(createHonchoClient(honchoFromEnv()!))],
+});
+
+await memory.ask({ question: 'What is still unresolved?', scope: { circle_id: 'circle:…' } });
+await memory.search({ query: 'lantern', scope: { subject_id: 'pde:…', exclude_ceremonies: ['…'] } });
+await memory.about({ person: 'node:human:…', scope: { participant: 'node:human:…' } });
+```
+
+Providers are tried in order. The first that answers gives the answer, and the wheel's own matches are added after its sources. When every provider fails, the wheel's records answer in `matched` mode with a `note`.
+
+Everyone else asks a wheel over HTTP (`POST /api/memory/ask`, `/search`, `/about`, `GET /api/memory`), through `@medicine-wheel/client` (`wheel.memory.ask(…)`), or through the MCP tools `memory_ask`, `memory_search`, `memory_about`, `memory_status`, `memory_conclude` and `memory_resend`.
+
+Also exported: `resolveReach` (scope to ceremonies), `matchRecords` and `queryTerms` (the text match), `excerptAround`, `isEmptyScope`.
+
+## Who decides who may ask
+
+The wheel keeps an answer inside the scope it is given. Deciding who may name which scope stays with the caller. Miadi, for example, builds the scope from the circles a person sits in.

package/dist/index.d.ts

@@ -0,0 +1,222 @@
+/**
+ * @medicine-wheel/memory — asking the wheel's memory, whoever keeps it.
+ *
+ * The wheel is canonical: ceremonies, turns (beats) and diary entries are
+ * recorded there. A memory provider (Honcho today) receives them and reasons
+ * over them. A caller asks the wheel, never the provider: it names a scope, the
+ * wheel turns the scope into the ceremonies it covers, and every provider is
+ * confined to that reach. Every source in an answer is a wheel record, or is
+ * marked as coming from outside the wheel.
+ *
+ * This package holds what does not depend on who keeps the memory: the
+ * contract, the rule that turns a scope into ceremonies, a text match over the
+ * wheel's own records (the provider that is always present), and the
+ * orchestration a wheel server and any other caller share. It has no
+ * dependencies. jgwill/medicine-wheel#149
+ */
+/** One value or several. */
+export type OneOrMany = string | string[];
+/**
+ * What a question may reach. Every field adds ceremonies and the reach is their
+ * union, less `exclude_ceremonies`. A scope with no field reaches nothing: the
+ * whole wheel is never the default.
+ */
+export interface MemoryScope {
+    /** Ceremony ids, reached as named. */
+    ceremonies?: OneOrMany;
+    /** Ceremonies held about these nodes (`CeremonyLog.subject_id`): a review, a PDE. */
+    subject_id?: OneOrMany;
+    /** Ceremonies held in these circles. */
+    circle_id?: OneOrMany;
+    /** Ceremonies bound to these chronicle episodes, and diary entries kept against them. */
+    episode_path?: OneOrMany;
+    /** Ceremonies where this person was seated: a participant, or a member or the facilitator of its circle. */
+    participant?: string;
+    /** Removed from the reach last, so a PDE's own ceremony is not cited as the answer to its own questions. */
+    exclude_ceremonies?: string[];
+}
+/** What a scope resolved to on this wheel. */
+export interface Reach {
+    scope: MemoryScope;
+    /** Ceremony ids, with the closing records of the ceremonies reached. */
+    ceremonies: string[];
+    /** Episode paths the scope names: diary entries kept against an episode rather than a ceremony. */
+    episodes: string[];
+}
+/**
+ * `dialectic`: a provider reasoned over the reach. `search`: a provider found
+ * the closest records without reasoning (it could not confine its reasoning, or
+ * reasoning was not asked for). `matched`: the wheel's own records matched on
+ * their words, with no provider. `empty`: the reach holds nothing, and nothing
+ * was asked.
+ */
+export type MemoryMode = 'dialectic' | 'search' | 'matched' | 'empty';
+/** One thing an answer rests on. */
+export interface MemorySource {
+    /** Who produced this source: `wheel` for the records match, or a provider's name. */
+    provider: string;
+    /** `beat`, `diary`, `ceremony`, or `message` for a source outside the wheel. */
+    wheel_kind: string;
+    /** The wheel record's id, or the provider's own id when `outside_wheel`. */
+    wheel_id: string;
+    /** The ceremony the record belongs to, when it belongs to one. */
+    ceremony_id?: string;
+    /** Who spoke or wrote it, as a wheel id when known. */
+    speaker?: string;
+    /** The speaker's name, resolved by the wheel. */
+    speaker_name?: string;
+    /** The words, shortened around what matched. Wheel person ids are replaced with names. */
+    excerpt: string;
+    /** When it was recorded. */
+    at?: string;
+    /** The provider holds it, but it carries no wheel record: it was written into the provider directly. */
+    outside_wheel?: boolean;
+}
+export interface MemoryAnswer {
+    /** The provider that answered, or `wheel` when only the records match did. */
+    provider: string;
+    mode: MemoryMode;
+    /** A reasoned answer, in `dialectic` mode only. */
+    answer?: string;
+    sources: MemorySource[];
+    reach: Reach;
+    /** Why the answer came from a fallback, when it did. */
+    note?: string;
+}
+/** A question as a provider receives it: the reach is already resolved. */
+export interface MemoryQuestion {
+    query: string;
+    reach: Reach;
+    /** Whose memory is asked. A provider picks its own default. */
+    peer?: string;
+    /** For `about`: the wheel id of the person the question is about. */
+    about?: string;
+    /** `minimal` | `low` | `medium` | `high` | `max`. */
+    reasoning_level?: string;
+    /** How many sources at most. */
+    limit?: number;
+}
+/** A provider's part of an answer; the wheel adds the reach. */
+export type ProviderAnswer = Omit<MemoryAnswer, 'reach'>;
+export interface MemoryProviderStatus {
+    provider: string;
+    /** Configured and reachable. */
+    enabled: boolean;
+    /** Can keep its reasoning inside a reach. A provider that cannot is asked for search only. */
+    confined?: boolean;
+    detail?: Record<string, unknown>;
+    error?: string;
+}
+/**
+ * Who keeps the memory. Receiving records stays with the wheel's projection on
+ * write (the river); a provider here answers questions within a reach.
+ */
+export interface MemoryProvider {
+    readonly name: string;
+    status(): Promise<MemoryProviderStatus>;
+    /** A reasoned answer within the reach, with the sources it drew on. */
+    ask(question: MemoryQuestion): Promise<ProviderAnswer>;
+    /** The records within the reach closest to the query, with no reasoning. */
+    search(question: MemoryQuestion): Promise<ProviderAnswer>;
+    /** What the provider holds about one person, within the reach. */
+    about?(question: MemoryQuestion & {
+        about: string;
+    }): Promise<ProviderAnswer>;
+}
+/** The fields of a ceremony the reach rule reads. */
+export interface CeremonyRef {
+    id: string;
+    subject_id?: string | null;
+    circle_id?: string | null;
+    /** The episode the ceremony is bound to, already read from its typed field or its legacy research_context. */
+    episode_path?: string | null;
+    /** Set on a closing record: the ceremony it closes. */
+    closes?: string | null;
+    participants?: string[];
+}
+/** A person's seat in a circle (member or facilitator). */
+export interface SeatRef {
+    person_id: string;
+    circle_id: string;
+}
+/** True when the scope names nothing, so it reaches nothing. */
+export declare function isEmptyScope(scope: MemoryScope | undefined | null): boolean;
+/**
+ * Turn a scope into the ceremonies it reaches, from the ceremonies this wheel
+ * holds. Fields combine as a union. A ceremony named in `ceremonies` that the
+ * wheel does not hold is left out. The closing record of a reached ceremony is
+ * reached with it, since its learnings belong to that ceremony.
+ * `exclude_ceremonies` is applied last, closings included.
+ */
+export declare function resolveReach(scope: MemoryScope, ceremonies: readonly CeremonyRef[], seats?: readonly SeatRef[]): Reach;
+/** A wheel record, flattened to what a text match reads. */
+export interface MemoryRecord {
+    wheel_kind: string;
+    wheel_id: string;
+    ceremony_id?: string;
+    speaker?: string;
+    text: string;
+    at?: string;
+}
+/** The words of a query a match can use: lower case, three letters or more, no stopword. */
+export declare function queryTerms(query: string): string[];
+/** A window of the text around the first term it contains. */
+export declare function excerptAround(text: string, terms: readonly string[], width?: number): string;
+/**
+ * Match a query against records on their words. A record scores one point per
+ * distinct query term it contains, and two more when it holds the whole query
+ * as written. Ties go to the more recent record. Records that match no term are
+ * left out.
+ */
+export declare function matchRecords(query: string, records: readonly MemoryRecord[], opts?: {
+    limit?: number;
+}): MemorySource[];
+/** What the wheel lends the orchestration: its ceremonies, seats, records and names. */
+export interface MemoryWheel {
+    ceremonies(): Promise<CeremonyRef[]>;
+    seats(): Promise<SeatRef[]>;
+    /** The beats, diary entries and ceremony records within the reach. */
+    records(reach: Reach): Promise<MemoryRecord[]>;
+    /** Names for wheel ids (people, the wheel itself). Unknown ids are left out. */
+    names(ids: string[]): Promise<Record<string, string>>;
+}
+export interface AskInput {
+    question: string;
+    scope: MemoryScope;
+    peer?: string;
+    reasoning_level?: string;
+    limit?: number;
+}
+export interface SearchInput {
+    query: string;
+    scope: MemoryScope;
+    limit?: number;
+}
+export interface AboutInput {
+    /** The wheel id of the person. */
+    person: string;
+    scope: MemoryScope;
+    question?: string;
+    limit?: number;
+}
+export interface Memory {
+    reach(scope: MemoryScope): Promise<Reach>;
+    status(): Promise<{
+        providers: MemoryProviderStatus[];
+    }>;
+    ask(input: AskInput): Promise<MemoryAnswer>;
+    search(input: SearchInput): Promise<MemoryAnswer>;
+    about(input: AboutInput): Promise<MemoryAnswer>;
+}
+/**
+ * The memory a wheel answers from. Providers are tried in order: the first that
+ * answers gives the answer, and when every provider fails the wheel's own
+ * records answer (`matched`). The records match always adds its sources, each
+ * naming its provider, so an answer can be checked against the wheel even when
+ * a provider reasoned it.
+ */
+export declare function createMemory(opts: {
+    wheel: MemoryWheel;
+    providers?: MemoryProvider[];
+}): Memory;
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,240 @@
+/**
+ * @medicine-wheel/memory — asking the wheel's memory, whoever keeps it.
+ *
+ * The wheel is canonical: ceremonies, turns (beats) and diary entries are
+ * recorded there. A memory provider (Honcho today) receives them and reasons
+ * over them. A caller asks the wheel, never the provider: it names a scope, the
+ * wheel turns the scope into the ceremonies it covers, and every provider is
+ * confined to that reach. Every source in an answer is a wheel record, or is
+ * marked as coming from outside the wheel.
+ *
+ * This package holds what does not depend on who keeps the memory: the
+ * contract, the rule that turns a scope into ceremonies, a text match over the
+ * wheel's own records (the provider that is always present), and the
+ * orchestration a wheel server and any other caller share. It has no
+ * dependencies. jgwill/medicine-wheel#149
+ */
+const list = (value) => (Array.isArray(value) ? value : value === undefined ? [] : [value]).map((v) => String(v).trim()).filter(Boolean);
+/** True when the scope names nothing, so it reaches nothing. */
+export function isEmptyScope(scope) {
+    if (!scope)
+        return true;
+    return (list(scope.ceremonies).length === 0 &&
+        list(scope.subject_id).length === 0 &&
+        list(scope.circle_id).length === 0 &&
+        list(scope.episode_path).length === 0 &&
+        !scope.participant?.trim());
+}
+/**
+ * Turn a scope into the ceremonies it reaches, from the ceremonies this wheel
+ * holds. Fields combine as a union. A ceremony named in `ceremonies` that the
+ * wheel does not hold is left out. The closing record of a reached ceremony is
+ * reached with it, since its learnings belong to that ceremony.
+ * `exclude_ceremonies` is applied last, closings included.
+ */
+export function resolveReach(scope, ceremonies, seats = []) {
+    const named = new Set(list(scope.ceremonies));
+    const subjects = new Set(list(scope.subject_id));
+    const circles = new Set(list(scope.circle_id));
+    const episodes = list(scope.episode_path);
+    const episodeSet = new Set(episodes);
+    const person = scope.participant?.trim();
+    const seated = new Set(person ? seats.filter((s) => s.person_id === person).map((s) => s.circle_id) : []);
+    const reached = new Set();
+    for (const c of ceremonies) {
+        if (named.has(c.id) ||
+            (c.subject_id && subjects.has(c.subject_id)) ||
+            (c.circle_id && circles.has(c.circle_id)) ||
+            (c.episode_path && episodeSet.has(c.episode_path)) ||
+            (person && ((c.participants ?? []).includes(person) || (c.circle_id && seated.has(c.circle_id))))) {
+            reached.add(c.id);
+        }
+    }
+    for (const c of ceremonies)
+        if (c.closes && reached.has(c.closes))
+            reached.add(c.id);
+    for (const id of scope.exclude_ceremonies ?? [])
+        reached.delete(id);
+    return { scope, ceremonies: [...reached], episodes };
+}
+const STOPWORDS = new Set(('the and for are but not you all any can had her was one our out has him his how its may new now old see two who did get let put say she too use what when where which while with this that than then them they there their these those from have into just more most much must only other over same some such very will would your about after again also been being before both could does each even ever here just like make many might never often once shall should still through under until upon whom whose why ' +
+    'les des une est pas pour que qui dans sur avec par mais comme plus tout tous elle ils elles nous vous leur leurs cette ces son ses sont été être avoir fait quoi quel quelle dont').split(/\s+/));
+/** The words of a query a match can use: lower case, three letters or more, no stopword. */
+export function queryTerms(query) {
+    const words = query.toLowerCase().normalize('NFKD').replace(/[̀-ͯ]/g, '').match(/[\p{L}\p{N}]+/gu) ?? [];
+    return [...new Set(words.filter((w) => w.length >= 3 && !STOPWORDS.has(w)))];
+}
+const fold = (text) => text.toLowerCase().normalize('NFKD').replace(/[̀-ͯ]/g, '');
+/** A window of the text around the first term it contains. */
+export function excerptAround(text, terms, width = 280) {
+    const flat = text.replace(/\s+/g, ' ').trim();
+    if (flat.length <= width)
+        return flat;
+    const folded = fold(flat);
+    const hits = terms.map((t) => folded.indexOf(t)).filter((i) => i >= 0);
+    const at = hits.length ? Math.min(...hits) : 0;
+    const start = Math.max(0, Math.min(at - Math.floor(width / 3), flat.length - width));
+    return `${start > 0 ? '…' : ''}${flat.slice(start, start + width).trim()}${start + width < flat.length ? '…' : ''}`;
+}
+/**
+ * Match a query against records on their words. A record scores one point per
+ * distinct query term it contains, and two more when it holds the whole query
+ * as written. Ties go to the more recent record. Records that match no term are
+ * left out.
+ */
+export function matchRecords(query, records, opts = {}) {
+    const terms = queryTerms(query);
+    if (terms.length === 0)
+        return [];
+    const phrase = fold(query.trim());
+    const scored = records
+        .map((r) => {
+        const text = fold(r.text);
+        const score = terms.filter((t) => text.includes(t)).length + (phrase.length > 3 && text.includes(phrase) ? 2 : 0);
+        return { r, score };
+    })
+        .filter((s) => s.score > 0)
+        .sort((a, b) => b.score - a.score || (b.r.at ?? '').localeCompare(a.r.at ?? ''));
+    return scored.slice(0, opts.limit ?? 12).map(({ r }) => ({
+        provider: 'wheel',
+        wheel_kind: r.wheel_kind,
+        wheel_id: r.wheel_id,
+        ...(r.ceremony_id ? { ceremony_id: r.ceremony_id } : {}),
+        ...(r.speaker ? { speaker: r.speaker } : {}),
+        excerpt: excerptAround(r.text, terms),
+        ...(r.at ? { at: r.at } : {}),
+    }));
+}
+/** Wheel person ids as they appear in projected text, e.g. `node:human:1789710466321:95nnhl`. */
+const PERSON_ID = /node:human:[0-9]+:[a-z0-9]+/g;
+/**
+ * The memory a wheel answers from. Providers are tried in order: the first that
+ * answers gives the answer, and when every provider fails the wheel's own
+ * records answer (`matched`). The records match always adds its sources, each
+ * naming its provider, so an answer can be checked against the wheel even when
+ * a provider reasoned it.
+ */
+export function createMemory(opts) {
+    const { wheel } = opts;
+    const providers = opts.providers ?? [];
+    async function reach(scope) {
+        if (isEmptyScope(scope))
+            return { scope: scope ?? {}, ceremonies: [], episodes: [] };
+        const [ceremonies, seats] = await Promise.all([wheel.ceremonies(), scope.participant ? wheel.seats() : Promise.resolve([])]);
+        return resolveReach(scope, ceremonies, seats);
+    }
+    const empty = (r) => ({ provider: 'wheel', mode: 'empty', sources: [], reach: r });
+    const isEmpty = (r) => r.ceremonies.length === 0 && r.episodes.length === 0;
+    async function named(answer) {
+        const ids = new Set();
+        for (const s of answer.sources) {
+            if (s.speaker)
+                ids.add(s.speaker);
+            for (const m of s.excerpt.match(PERSON_ID) ?? [])
+                ids.add(m);
+        }
+        for (const m of answer.answer?.match(PERSON_ID) ?? [])
+            ids.add(m);
+        if (ids.size === 0)
+            return answer;
+        const names = await wheel.names([...ids]).catch(() => ({}));
+        const swap = (text) => text.replace(PERSON_ID, (id) => names[id] ?? id);
+        return {
+            ...answer,
+            ...(answer.answer !== undefined ? { answer: swap(answer.answer) } : {}),
+            sources: answer.sources.map((s) => ({
+                ...s,
+                excerpt: swap(s.excerpt),
+                ...(s.speaker && names[s.speaker] ? { speaker_name: names[s.speaker] } : {}),
+            })),
+        };
+    }
+    /** Provider sources first, then the records match, one source per wheel record. */
+    function merge(first, second, limit) {
+        const seen = new Set();
+        const out = [];
+        for (const s of [...first, ...second]) {
+            const key = s.outside_wheel ? `${s.provider}:${s.wheel_id}` : s.wheel_id;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            out.push(s);
+        }
+        return out.slice(0, limit);
+    }
+    async function answer(r, matched, limit, ask) {
+        const failures = [];
+        for (const p of providers) {
+            const pending = ask(p);
+            if (!pending)
+                continue;
+            try {
+                const got = await pending;
+                return named({ ...got, sources: merge(got.sources, matched, limit), reach: r });
+            }
+            catch (error) {
+                failures.push(`${p.name}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        return named({
+            provider: 'wheel',
+            mode: 'matched',
+            sources: matched,
+            reach: r,
+            ...(providers.length === 0
+                ? { note: 'No memory provider is configured; the wheel matched its own records.' }
+                : failures.length
+                    ? { note: `No provider answered (${failures.join('; ')}); the wheel matched its own records.` }
+                    : {}),
+        });
+    }
+    return {
+        reach,
+        async status() {
+            const statuses = await Promise.all(providers.map((p) => p.status().catch((error) => ({ provider: p.name, enabled: false, error: error instanceof Error ? error.message : String(error) }))));
+            return { providers: [...statuses, { provider: 'wheel', enabled: true, confined: true, detail: { mode: 'matched' } }] };
+        },
+        async ask(input) {
+            const r = await reach(input.scope);
+            if (isEmpty(r))
+                return empty(r);
+            const limit = input.limit ?? 12;
+            const matched = matchRecords(input.question, await wheel.records(r), { limit });
+            return answer(r, matched, limit, (p) => p.ask({ query: input.question, reach: r, peer: input.peer, reasoning_level: input.reasoning_level, limit }));
+        },
+        async search(input) {
+            const r = await reach(input.scope);
+            if (isEmpty(r))
+                return empty(r);
+            const limit = input.limit ?? 12;
+            const matched = matchRecords(input.query, await wheel.records(r), { limit });
+            return answer(r, matched, limit, (p) => p.search({ query: input.query, reach: r, limit }));
+        },
+        async about(input) {
+            const r = await reach(input.scope);
+            if (isEmpty(r))
+                return empty(r);
+            const limit = input.limit ?? 12;
+            const query = input.question ?? '';
+            // From the wheel's own records, only what this person said or wrote: the closest to the
+            // question when there is one, else the most recent.
+            const theirs = (await wheel.records(r)).filter((rec) => rec.speaker === input.person);
+            const matched = query.trim()
+                ? matchRecords(query, theirs, { limit })
+                : [...theirs]
+                    .sort((a, b) => (b.at ?? '').localeCompare(a.at ?? ''))
+                    .slice(0, limit)
+                    .map((rec) => ({
+                    provider: 'wheel',
+                    wheel_kind: rec.wheel_kind,
+                    wheel_id: rec.wheel_id,
+                    ...(rec.ceremony_id ? { ceremony_id: rec.ceremony_id } : {}),
+                    speaker: rec.speaker,
+                    excerpt: excerptAround(rec.text, []),
+                    ...(rec.at ? { at: rec.at } : {}),
+                }));
+            return answer(r, matched, limit, (p) => (p.about ? p.about({ query, reach: r, about: input.person, limit }) : null));
+        },
+    };
+}
+//# 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;;;;;;;;;;;;;;;GAeG;AA6IH,MAAM,IAAI,GAAG,CAAC,KAA4B,EAAY,EAAE,CACtD,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAEnH,gEAAgE;AAChE,MAAM,UAAU,YAAY,CAAC,KAAqC;IAChE,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,CACL,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC;QAClC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC;QACrC,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,CAC3B,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAkB,EAAE,UAAkC,EAAE,QAA4B,EAAE;IACjH,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAE1G,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IACE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACf,CAAC,CAAC,CAAC,UAAU,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;YAC5C,CAAC,CAAC,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACzC,CAAC,CAAC,CAAC,YAAY,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;YAClD,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EACjG,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,UAAU;QAAE,IAAI,CAAC,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrF,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,kBAAkB,IAAI,EAAE;QAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACpE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC;AACvD,CAAC;AAcD,MAAM,SAAS,GAAG,IAAI,GAAG,CACvB,CACE,wfAAwf;IACxf,mLAAmL,CACpL,CAAC,KAAK,CAAC,KAAK,CAAC,CACf,CAAC;AAEF,4FAA4F;AAC5F,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;IACzG,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAE1F,8DAA8D;AAC9D,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,KAAwB,EAAE,KAAK,GAAG,GAAG;IAC/E,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACvE,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC;IACrF,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACtH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,OAAgC,EAAE,OAA2B,EAAE;IACzG,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,OAAO;SACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClH,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;IACtB,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;SAC1B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACnF,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACvD,QAAQ,EAAE,OAAO;QACjB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC;QACrC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9B,CAAC,CAAC,CAAC;AACN,CAAC;AAoCD,iGAAiG;AACjG,MAAM,SAAS,GAAG,8BAA8B,CAAC;AAUjD;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,IAA0D;IACrF,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IACvB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;IAEvC,KAAK,UAAU,KAAK,CAAC,KAAkB;QACrC,IAAI,YAAY,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QACrF,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7H,OAAO,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,CAAQ,EAAgB,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACxG,MAAM,OAAO,GAAG,CAAC,CAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC;IAEnF,KAAK,UAAU,KAAK,CAAC,MAAoB;QACvC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/B,IAAI,CAAC,CAAC,OAAO;gBAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAClC,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE;gBAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC/D,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE;YAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAClE,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC;QAClC,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAA6B,CAAA,CAAC,CAAC;QACtF,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QAChF,OAAO;YACL,GAAG,MAAM;YACT,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAClC,GAAG,CAAC;gBACJ,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;gBACxB,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC7E,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IAED,mFAAmF;IACnF,SAAS,KAAK,CAAC,KAAqB,EAAE,MAAsB,EAAE,KAAa;QACzE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,MAAM,GAAG,GAAmB,EAAE,CAAC;QAC/B,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;YACtC,MAAM,GAAG,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YACzE,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACd,CAAC;QACD,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,UAAU,MAAM,CACnB,CAAQ,EACR,OAAuB,EACvB,KAAa,EACb,GAA0D;QAE1D,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YACvB,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC;gBAC1B,OAAO,KAAK,CAAC,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YAClF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACxF,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;YACX,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,CAAC;YACR,GAAG,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;gBACxB,CAAC,CAAC,EAAE,IAAI,EAAE,sEAAsE,EAAE;gBAClF,CAAC,CAAC,QAAQ,CAAC,MAAM;oBACf,CAAC,CAAC,EAAE,IAAI,EAAE,yBAAyB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,uCAAuC,EAAE;oBAC/F,CAAC,CAAC,EAAE,CAAC;SACV,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,KAAK;QACL,KAAK,CAAC,MAAM;YACV,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CACzJ,CAAC;YACF,OAAO,EAAE,SAAS,EAAE,CAAC,GAAG,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC;QACzH,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,KAAK;YACb,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACnC,IAAI,OAAO,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAChF,OAAO,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,CAAC,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QACvJ,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,KAAK;YAChB,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACnC,IAAI,OAAO,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7E,OAAO,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC7F,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,KAAK;YACf,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACnC,IAAI,OAAO,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;YACnC,wFAAwF;YACxF,oDAAoD;YACpD,MAAM,MAAM,GAAG,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC;YACtF,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE;gBAC1B,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC;gBACxC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;qBACR,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtD,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;qBACf,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;oBACb,QAAQ,EAAE,OAAO;oBACjB,UAAU,EAAE,GAAG,CAAC,UAAU;oBAC1B,QAAQ,EAAE,GAAG,CAAC,QAAQ;oBACtB,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC5D,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;oBACpC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAClC,CAAC,CAAC,CAAC;YACV,OAAO,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACvH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@medicine-wheel/memory",
+  "version": "0.16.0",
+  "type": "module",
+  "description": "Asking the wheel's memory, whoever keeps it: one contract that names no provider (scope, reach, answer, source, provider), the rule that turns a scope into ceremonies, a text match over the wheel's own records, and the orchestration a wheel server or any caller shares. Zero dependencies.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "medicine-wheel",
+    "memory",
+    "ceremony",
+    "talking-circle",
+    "provider",
+    "contract"
+  ],
+  "author": "IAIP Collaborative - Shawinigan, QC",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jgwill/medicine-wheel.git",
+    "directory": "src/memory"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  }
+}