@noopolis/mneme 0.1.0

package/README.md

@@ -0,0 +1,83 @@
+# Mneme
+
+Mneme is the Noopolis scoped memory runtime for agentic systems.
+
+It provides:
+
+- an append-only JSONL memory ledger;
+- a rebuildable SQLite search index;
+- scoped access and redaction policy;
+- runtime-neutral memory tool descriptors;
+- an MCP stdio server for external runtimes.
+
+The package can be used directly by a host runtime or exposed through MCP.
+
+## Install Locally
+
+During incubation, sibling projects can depend on this package without a
+published npm release:
+
+```json
+{
+  "dependencies": {
+    "@noopolis/mneme": "file:../mneme"
+  }
+}
+```
+
+Then run:
+
+```bash
+npm install
+```
+
+## MCP Server
+
+Start a local stdio MCP server for one agent:
+
+```bash
+mneme mcp \
+  --runtime-home ./.runtime/agent-a \
+  --agent-id agent-a \
+  --conversation-scope global
+```
+
+The server exposes:
+
+- `memory_search`
+- `memory_locate`
+- `memory_register`
+- `memory_summarize`
+- `memory_forget`
+
+The MCP adapter uses the same kernel as direct in-process integrations. The
+transport only changes the envelope metadata.
+
+## Environment
+
+The CLI also accepts environment variables:
+
+```bash
+MNEME_RUNTIME_HOME=./.runtime/agent-a \
+MNEME_AGENT_ID=agent-a \
+mneme mcp
+```
+
+Useful variables:
+
+- `MNEME_RUNTIME_HOME`
+- `MNEME_AGENT_ID`
+- `MNEME_AGENT_SCOPE`
+- `MNEME_AGENT_QUALIFIER`
+- `MNEME_CONVERSATION_SCOPE`
+- `MNEME_AUDIENCE_KEY`
+- `MNEME_POLICY_VERSION`
+
+## Development
+
+```bash
+npm install
+npm run typecheck
+npm test
+npm run build
+```

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/cli/index.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+const printUsage = () => {
+    process.stderr.write(`Usage:
+  mneme mcp --runtime-home <path> --agent-id <id> [options]
+
+Options:
+  --agent-scope <scope>          Principal scope. Default: global
+  --agent-qualifier <value>      Principal qualifier for room/team/pair/task scopes
+  --conversation-scope <scope>   Conversation scope id. Default: principal scope id
+  --audience-key <key>           Audience key. Default: agent id
+  --policy-version <version>     Policy version. Default: memory-policy.v1
+  --source <label>               Source label for generated memory events
+  --token-budget <number>        Default recall token budget
+
+Environment:
+  MNEME_RUNTIME_HOME
+  MNEME_AGENT_ID
+  MNEME_AGENT_SCOPE
+  MNEME_AGENT_QUALIFIER
+  MNEME_CONVERSATION_SCOPE
+  MNEME_AUDIENCE_KEY
+  MNEME_POLICY_VERSION
+  MNEME_SOURCE
+  MNEME_TOKEN_BUDGET
+`);
+};
+const main = async () => {
+    const [command, ...args] = process.argv.slice(2);
+    if (command === "help" || command === "--help" || command === "-h") {
+        printUsage();
+        return;
+    }
+    if (command !== "mcp") {
+        printUsage();
+        process.exitCode = 2;
+        return;
+    }
+    const { connectMnemeMcpStdio } = await import("../mcp/server.js");
+    const { parseMnemeMcpArgs } = await import("../mcp/config.js");
+    await connectMnemeMcpStdio(parseMnemeMcpArgs(args));
+};
+main().catch((error) => {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+});
+export {};

package/dist/contract/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./toolDescriptors.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contract/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC"}

package/dist/contract/index.js

@@ -0,0 +1,2 @@
+export * from "./toolDescriptors.js";
+export * from "./types.js";

package/dist/contract/toolDescriptors.d.ts

@@ -0,0 +1,14 @@
+import type { MemoryExecutableToolName, MemoryKernel, MemoryModelToolName, MemoryToolCallEnvelope, MemoryToolDescriptor, MemoryToolExecutionContext } from "./types.js";
+interface MemoryToolSpec {
+    name: MemoryExecutableToolName;
+    modelName: MemoryModelToolName;
+    label: string;
+    description: string;
+    promptSnippet: string;
+    promptGuidelines: string[];
+}
+export declare const memoryToolSpecs: MemoryToolSpec[];
+export declare const createMemoryToolEnvelope: (context: MemoryToolExecutionContext) => MemoryToolCallEnvelope;
+export declare const createMemoryToolDescriptors: (kernel: MemoryKernel) => MemoryToolDescriptor[];
+export {};
+//# sourceMappingURL=toolDescriptors.d.ts.map

package/dist/contract/toolDescriptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolDescriptors.d.ts","sourceRoot":"","sources":["../../src/contract/toolDescriptors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,YAAY,EACZ,mBAAmB,EAEnB,sBAAsB,EACtB,oBAAoB,EACpB,0BAA0B,EAE3B,MAAM,YAAY,CAAC;AAYpB,UAAU,cAAc;IACtB,IAAI,EAAE,wBAAwB,CAAC;IAC/B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,eAAO,MAAM,eAAe,EAAE,cAAc,EAqD3C,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,SAAS,0BAA0B,KAClC,sBAaD,CAAC;AAyBH,eAAO,MAAM,2BAA2B,GACtC,QAAQ,YAAY,KACnB,oBAAoB,EAKlB,CAAC"}

package/dist/contract/toolDescriptors.js

@@ -0,0 +1,98 @@
+const defaultScopeAliases = [
+    "current",
+    "global",
+    "public_profile",
+    "public_facts",
+    "current_room",
+    "current_pair",
+    "current_task"
+];
+export const memoryToolSpecs = [
+    {
+        name: "memory.search",
+        modelName: "memory_search",
+        label: "Memory Search",
+        description: "Search scoped long-term memory through the policy boundary.",
+        promptSnippet: "Search scoped memory for relevant prior events.",
+        promptGuidelines: [
+            "Use memory_search before answering when prior room, pair, team, or global context may matter.",
+            "Treat redacted or private results as boundaries; do not infer hidden content."
+        ]
+    },
+    {
+        name: "memory.locate",
+        modelName: "memory_locate",
+        label: "Memory Locate",
+        description: "Locate which scoped memories may contain an answer without exposing private content.",
+        promptSnippet: "Locate memory candidates without necessarily exposing their content.",
+        promptGuidelines: [
+            "Use memory_locate when you suspect another scope has relevant history but need to respect privacy."
+        ]
+    },
+    {
+        name: "memory.register",
+        modelName: "memory_register",
+        label: "Memory Register",
+        description: "Register a durable memory with explicit evidence and visibility.",
+        promptSnippet: "Register durable memories with evidence and an explicit visibility.",
+        promptGuidelines: [
+            "Use memory_register for stable facts, decisions, relationships, or artifacts that should survive future turns.",
+            "Choose the narrowest visibility that fits the memory."
+        ]
+    },
+    {
+        name: "memory.summarize",
+        modelName: "memory_summarize",
+        label: "Memory Summarize",
+        description: "Summarize recent memory in a scope and store the summary as memory.",
+        promptSnippet: "Summarize a memory scope when history is too verbose.",
+        promptGuidelines: [
+            "Use memory_summarize to compact a scope before a long-running task or after a meaningful exchange."
+        ]
+    },
+    {
+        name: "memory.forget",
+        modelName: "memory_forget",
+        label: "Memory Forget",
+        description: "Write tombstones for memories that should no longer be recalled.",
+        promptSnippet: "Forget memories by writing tombstones instead of mutating history.",
+        promptGuidelines: [
+            "Use memory_forget only for explicitly obsolete, wrong, or policy-unsafe memories."
+        ]
+    }
+];
+export const createMemoryToolEnvelope = (context) => ({
+    version: "mneme.memory.tool.v1",
+    wake_id: context.wakeId,
+    thread_id: context.threadId,
+    principal: context.principal,
+    conversation_scope: context.conversationScope,
+    audience_key: context.audienceKey ?? context.principal.agentId,
+    policy_version: context.policyVersion ?? "memory-policy.v1",
+    allowed_scope_aliases: context.allowedScopeAliases ?? defaultScopeAliases,
+    transport: context.transport ?? "in_process",
+    nonce: context.nonce ?? `${context.wakeId}:${Date.now()}`,
+    expires_at: context.expiresAt ?? new Date(Date.now() + 5 * 60_000).toISOString(),
+    capability: context.capability ?? "memory"
+});
+const createMemoryToolCall = (tool, argumentsValue, context) => ({
+    request_id: `${context.wakeId}:${tool}:${Date.now()}`,
+    tool,
+    arguments: argumentsValue,
+    envelope: createMemoryToolEnvelope(context)
+});
+const executeMemoryTool = (kernel, tool, call) => {
+    if (tool === "memory.search")
+        return kernel.search(call);
+    if (tool === "memory.locate")
+        return kernel.locate(call);
+    if (tool === "memory.register")
+        return kernel.register(call);
+    if (tool === "memory.summarize")
+        return kernel.summarize(call);
+    return kernel.forget(call);
+};
+export const createMemoryToolDescriptors = (kernel) => memoryToolSpecs.map((spec) => ({
+    ...spec,
+    invoke: (argumentsValue, context) => executeMemoryTool(kernel, spec.name, createMemoryToolCall(spec.name, argumentsValue, context))
+}));

package/dist/contract/types.d.ts

@@ -0,0 +1,262 @@
+export interface MemoryPrincipalRef {
+    agentId: string;
+    scope: "global" | "team" | "room" | "pair" | "task" | "role" | "artifact";
+    qualifier?: string;
+}
+export type MemoryWakeKind = "manual" | "message" | "schedule";
+export interface MemoryToolCallEnvelope {
+    version: "mneme.memory.tool.v1";
+    wake_id: string;
+    thread_id: string;
+    principal: MemoryPrincipalRef;
+    conversation_scope: string;
+    audience_key: string;
+    policy_version: string;
+    allowed_scope_aliases: ReadonlyArray<"current" | "global" | "public_profile" | "public_facts" | "current_room" | "current_pair" | "current_task">;
+    transport: "in_process" | "mcp" | "protocol" | "text_loop";
+    nonce: string;
+    expires_at: string;
+    capability: string;
+}
+export type MemoryToolName = "memory.search" | "memory.locate" | "memory.register" | "memory.write" | "memory.summarize" | "memory.forget";
+export type MemoryExecutableToolName = Exclude<MemoryToolName, "memory.write">;
+export type MemoryModelToolName = "memory_search" | "memory_locate" | "memory_register" | "memory_summarize" | "memory_forget";
+export interface MemoryToolExecutionContext {
+    wakeId: string;
+    threadId: string;
+    principal: MemoryPrincipalRef;
+    conversationScope: string;
+    audienceKey?: string;
+    policyVersion?: string;
+    allowedScopeAliases?: MemoryToolCallEnvelope["allowed_scope_aliases"];
+    transport?: MemoryToolCallEnvelope["transport"];
+    expiresAt?: string;
+    nonce?: string;
+    capability?: string;
+}
+export interface MemoryToolCall {
+    request_id: string;
+    tool: MemoryToolName;
+    arguments: Record<string, unknown>;
+    envelope: MemoryToolCallEnvelope;
+}
+export type MemoryToolDecision = "allow_raw" | "allow_summary" | "allow_redacted_summary" | "known_but_private" | "locate_only" | "deny" | "unavailable" | "malformed_request";
+export interface MemoryContext {
+    networkId?: string;
+    roomId?: string;
+    teamId?: string;
+    taskId?: string;
+    roleId?: string;
+    pairPeers?: string[];
+    artifactPaths?: string[];
+    from?: string;
+}
+export interface WakeMemoryContext extends MemoryContext {
+    participants?: string[];
+}
+export interface MemoryToolResultContent {
+    kind: "memory" | "claim" | "narrative" | "relationship" | "artifact" | "locate";
+    text?: string;
+    event_ids: string[];
+    scope?: string;
+    principal?: MemoryPrincipalRef;
+    confidence?: number;
+    redactions: string[];
+}
+export interface MemoryToolAudit {
+    request_id: string;
+    requester: MemoryPrincipalRef;
+    sources: MemoryPrincipalRef[];
+    transport: "in_process" | "mcp" | "protocol" | "text_loop";
+    latency_ms: number;
+    argument_hash?: string;
+}
+export interface MemoryToolResult {
+    request_id: string;
+    tool: MemoryToolName;
+    decision: MemoryToolDecision;
+    content: MemoryToolResultContent[];
+    audit: MemoryToolAudit;
+    error?: string;
+}
+export interface MemorySearchArguments {
+    scope: string;
+    query: string;
+    limit?: number;
+}
+export interface MemoryLocateArguments {
+    query: string;
+    limit?: number;
+    active_scope?: string;
+}
+export type MemoryRegisterKind = MemoryContent["kind"] | "text";
+export interface MemoryRegisterArguments {
+    scope: string;
+    kind: MemoryRegisterKind;
+    content: MemoryContent;
+    visibility: MemoryVisibility;
+    sensitivity: MemorySensitivity;
+    evidence_event_ids: string[];
+    source_type: string;
+    confidence?: number;
+    principal?: MemoryPrincipalRef;
+}
+export interface MemorySummarizeArguments {
+    scope: string;
+    horizon?: number;
+}
+export interface MemoryForgetArguments {
+    scope: string;
+    event_ids: string[];
+    reason?: string;
+}
+export interface MemoryKernel {
+    search(call: MemoryToolCall): Promise<MemoryToolResult>;
+    locate(call: MemoryToolCall): Promise<MemoryToolResult>;
+    register(call: MemoryToolCall): Promise<MemoryToolResult>;
+    summarize(call: MemoryToolCall): Promise<MemoryToolResult>;
+    forget(call: MemoryToolCall): Promise<MemoryToolResult>;
+}
+export interface MemoryToolDescriptor {
+    name: MemoryExecutableToolName;
+    modelName: MemoryModelToolName;
+    label: string;
+    description: string;
+    promptSnippet: string;
+    promptGuidelines: string[];
+    invoke(argumentsValue: Record<string, unknown>, context: MemoryToolExecutionContext): Promise<MemoryToolResult>;
+}
+export type MemoryVisibility = "private" | "pair" | "team" | "room" | "global" | "public" | "sealed";
+export type MemorySensitivity = "normal" | "sensitive" | "secret";
+export type MemoryEventType = "memory.observed" | "memory.claimed" | "memory.registered" | "memory.summarized" | "memory.recalled" | "memory.located" | "memory.denied" | "memory.forgotten";
+export type MemoryContent = {
+    kind: "text";
+    text: string;
+} | {
+    kind: "claim";
+    subject: string;
+    predicate: string;
+    object: string;
+} | {
+    kind: "decision";
+    decision: string;
+    rationale?: string;
+} | {
+    kind: "artifact";
+    path?: string;
+    uri?: string;
+    description: string;
+} | {
+    kind: "relationship";
+    from: string;
+    relation: string;
+    to: string;
+};
+export interface MemoryEvent {
+    id: string;
+    type: MemoryEventType;
+    createdAt: string;
+    principal: MemoryPrincipalRef;
+    scope: string;
+    visibility: MemoryVisibility;
+    source: string;
+    content: MemoryContent;
+    tags: string[];
+    entities: string[];
+    sensitivity: MemorySensitivity;
+    confidence?: number;
+    ttl?: string;
+    parentEventIds: string[];
+    checksum: string;
+}
+export interface MemoryEventInput {
+    type: MemoryEventType;
+    principal: MemoryPrincipalRef;
+    scope: string;
+    visibility: MemoryVisibility;
+    source: string;
+    content: MemoryContent;
+    tags?: string[];
+    entities?: string[];
+    sensitivity?: MemorySensitivity;
+    confidence?: number;
+    ttl?: string;
+    parentEventIds?: string[];
+}
+export type MemoryDecision = "allow_raw" | "allow_summary" | "allow_redacted_summary" | "known_but_private" | "locate_only" | "deny" | "unavailable" | "malformed_request";
+export interface MemoryPolicyInput {
+    request: MemoryPrincipalRef;
+    activeScope?: MemoryPrincipalRef;
+    candidate: MemoryEvent;
+}
+export interface MemoryRecallAudit {
+    totalCandidates: number;
+    selectedEventIds: string[];
+    selected?: Array<{
+        eventId: string;
+        decision: MemoryDecision;
+        scope: string;
+        representation: string;
+    }>;
+    decisions: Array<{
+        eventId: string;
+        decision: MemoryDecision;
+        reason: string;
+    }>;
+    tokenBudgetUsed: number;
+    redactionCount: number;
+}
+export interface MemoryPacket {
+    principal: MemoryPrincipalRef;
+    sections: Array<{
+        heading: string;
+        text: string;
+    }>;
+    rawHint?: string;
+}
+export interface MemoryPacketInput {
+    activePrincipal: MemoryPrincipalRef;
+    event: {
+        id: string;
+        kind: string;
+        text: string;
+        from?: string;
+    };
+    context: WakeMemoryContext;
+    recalls: Array<{
+        event: MemoryEvent;
+        decision: MemoryDecision;
+        representation: string;
+        scope: string;
+    }>;
+}
+export interface MemoryRecallRequest {
+    eventId: string;
+    kind: MemoryWakeKind;
+    text: string;
+    from?: string;
+    context: WakeMemoryContext;
+    tokenBudget?: number;
+}
+export interface MemoryPrepareTurnResult {
+    principal: MemoryPrincipalRef;
+    packet: MemoryPacket;
+    promptText: string;
+    recall: MemoryRecallAudit;
+}
+export interface MemoryTurnRecord {
+    principal: MemoryPrincipalRef;
+    prompt: MemoryPacket;
+    request: MemoryRecallRequest;
+    recall?: MemoryRecallAudit;
+    result: "completed" | "failed";
+    outputText: string;
+    toolEvents?: unknown[];
+    error?: string;
+}
+export interface MemoryRuntime {
+    prepareTurn(request: MemoryRecallRequest): Promise<MemoryPrepareTurnResult>;
+    recordTurn(input: MemoryTurnRecord): Promise<void>;
+    kernel: MemoryKernel;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/contract/types.js

@@ -0,0 +1 @@
+export {};

package/dist/identity/ids.d.ts

@@ -0,0 +1,9 @@
+import type { MemoryEvent, MemoryPrincipalRef, MemoryEventInput } from "../contract/types.js";
+export declare const canonicalPrincipalKey: (principal: MemoryPrincipalRef) => string;
+export declare const canonicalScopeKey: (scope?: string) => string;
+export declare const pairScopeId: (left: string, right: string) => string;
+export declare const makeEventId: () => string;
+export declare const makeChecksum: (event: MemoryEventInput | MemoryEvent) => string;
+export declare const memoryScopeId: (principal: MemoryPrincipalRef) => string;
+export declare const sanitizePrincipalQualifier: (value?: string) => string | undefined;
+//# sourceMappingURL=ids.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/identity/ids.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,qBAAqB,GAAI,WAAW,kBAAkB,KAAG,MAMrE,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,KAAG,MAA2C,CAAC;AAE/F,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,KAAG,MAGzD,CAAC;AAEF,eAAO,MAAM,WAAW,QAAO,MAA+B,CAAC;AAE/D,eAAO,MAAM,YAAY,GAAI,OAAO,gBAAgB,GAAG,WAAW,KAAG,MAGpE,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,WAAW,kBAAkB,KAAG,MAC5B,CAAC;AAEnC,eAAO,MAAM,0BAA0B,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAKpE,CAAC"}

package/dist/identity/ids.js

@@ -0,0 +1,25 @@
+import { createHash, randomUUID } from "node:crypto";
+export const canonicalPrincipalKey = (principal) => {
+    const parts = [`agent:${principal.agentId}`, `scope:${principal.scope}`];
+    if (principal.qualifier) {
+        parts.push(`qualifier:${principal.qualifier}`);
+    }
+    return parts.join("/");
+};
+export const canonicalScopeKey = (scope) => scope?.trim().toLowerCase() ?? "";
+export const pairScopeId = (left, right) => {
+    const sorted = [left, right].map((value) => value.trim()).sort();
+    return `${sorted[0]}::${sorted[1]}`;
+};
+export const makeEventId = () => `evt_${randomUUID()}`;
+export const makeChecksum = (event) => {
+    const content = JSON.stringify(event);
+    return createHash("sha256").update(content).digest("hex");
+};
+export const memoryScopeId = (principal) => canonicalPrincipalKey(principal);
+export const sanitizePrincipalQualifier = (value) => {
+    if (!value) {
+        return value;
+    }
+    return value.trim().toLowerCase();
+};

package/dist/identity/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./ids.js";
+export * from "./scope.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/identity/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

package/dist/identity/index.js

@@ -0,0 +1,2 @@
+export * from "./ids.js";
+export * from "./scope.js";

package/dist/identity/scope.d.ts

@@ -0,0 +1,24 @@
+import type { WakeMemoryContext, MemoryPrincipalRef, MemoryWakeKind } from "../contract/types.js";
+export interface ResolvedScopePlan {
+    activePrincipal: MemoryPrincipalRef;
+    readableScopes: MemoryPrincipalRef[];
+    candidateScopes: MemoryPrincipalRef[];
+    deniedScopes: MemoryPrincipalRef[];
+}
+export declare const resolveScopePlan: (input: {
+    agentId: string;
+    context?: WakeMemoryContext;
+    wake: {
+        id?: string;
+        kind: MemoryWakeKind;
+        from?: string;
+    };
+}) => ResolvedScopePlan;
+export declare const readMemoryContext: (event: {
+    kind: MemoryWakeKind;
+    from?: string;
+    text: string;
+    id?: string;
+    context?: WakeMemoryContext;
+}) => WakeMemoryContext;
+//# sourceMappingURL=scope.d.ts.map

package/dist/identity/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/identity/scope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAiB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEjH,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,kBAAkB,CAAC;IACpC,cAAc,EAAE,kBAAkB,EAAE,CAAC;IACrC,eAAe,EAAE,kBAAkB,EAAE,CAAC;IACtC,YAAY,EAAE,kBAAkB,EAAE,CAAC;CACpC;AA+DD,eAAO,MAAM,gBAAgB,GAAI,OAAO;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,IAAI,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,cAAc,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D,KAAG,iBA4DH,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,OAAO;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,iBAAiB,CAAA;CAAE,KACrG,iBAkBF,CAAC"}