@runcore-sh/runcore 0.1.2

package/dist/brain/skills.js

@@ -0,0 +1,452 @@
+/**
+ * Skill schema validation for Core agent skills.
+ *
+ * Validates `.yml` skill files in `brain/skills/` against the schema
+ * defined in `brain/skills/schema.yml`.
+ *
+ * @example
+ * ```ts
+ * import { validateSkill, parseSkillYaml } from "./brain/skills.js";
+ *
+ * const raw = fs.readFileSync("brain/skills/file-editing.yml", "utf-8");
+ * const parsed = parseSkillYaml(raw);
+ * const result = validateSkill(parsed);
+ *
+ * if (!result.valid) {
+ *   console.error("Validation errors:", result.errors);
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { validateSkillFile } from "./brain/skills.js";
+ *
+ * const result = await validateSkillFile("brain/skills/git-operations.yml");
+ * if (result.valid) {
+ *   console.log("Skill:", result.skill!.name);
+ * }
+ * ```
+ */
+import { readFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+const REQUIRED_FIELDS = [
+    "name",
+    "description",
+    "tools",
+    "context_patterns",
+    "example_prompt",
+];
+const ARRAY_FIELDS = new Set([
+    "tools",
+    "context_patterns",
+    "tags",
+    "depends_on",
+]);
+const ALL_KNOWN_FIELDS = new Set([
+    ...REQUIRED_FIELDS,
+    "version",
+    "tags",
+    "depends_on",
+    "notes",
+]);
+const NAME_PATTERN = /^[a-z][a-z0-9-]*$/;
+/**
+ * Parse a flat YAML skill file into a key-value record.
+ *
+ * Handles simple scalars (`key: value`), folded scalars (`key: >`),
+ * and arrays (`key:` + `- item` lines). Not a general-purpose YAML
+ * parser — designed for the specific structure of Core skill files.
+ *
+ * @example
+ * ```ts
+ * const parsed = parseSkillYaml(`
+ * name: my-skill
+ * tools:
+ *   - git
+ *   - npm
+ * description: >
+ *   A multi-line
+ *   description here.
+ * `);
+ * // { name: "my-skill", tools: ["git", "npm"], description: "A multi-line description here." }
+ * ```
+ */
+export function parseSkillYaml(content) {
+    const result = {};
+    const lines = content.split("\n");
+    let currentKey = null;
+    let currentMode = null;
+    let foldedLines = [];
+    function flushFolded() {
+        if (currentKey && currentMode === "folded" && foldedLines.length > 0) {
+            result[currentKey] = foldedLines.join(" ").trim();
+            foldedLines = [];
+        }
+    }
+    for (const line of lines) {
+        // Skip comments and blank lines at top level
+        if (line.trimStart().startsWith("#"))
+            continue;
+        // Top-level key: detect `key: value`, `key: >`, or `key:` (array)
+        const topMatch = line.match(/^([a-z_][a-z0-9_]*)\s*:\s*(.*)/);
+        if (topMatch) {
+            flushFolded();
+            const key = topMatch[1];
+            const rest = topMatch[2].trim();
+            currentKey = key;
+            if (rest === ">") {
+                // Folded scalar — collect indented lines
+                currentMode = "folded";
+                foldedLines = [];
+            }
+            else if (rest === "" || rest === "|") {
+                // Could be array (next lines are `- item`) or literal block
+                currentMode = "array";
+                result[key] = [];
+            }
+            else {
+                // Simple scalar value — strip surrounding quotes
+                currentMode = "scalar";
+                result[key] = rest.replace(/^["']|["']$/g, "");
+            }
+            continue;
+        }
+        // Indented content: array items or folded continuation
+        if (currentKey && line.match(/^\s+/)) {
+            const trimmed = line.trim();
+            if (trimmed === "") {
+                // Blank line inside folded → paragraph break (ignored, just space)
+                continue;
+            }
+            if (currentMode === "array") {
+                const itemMatch = trimmed.match(/^-\s+(.*)/);
+                if (itemMatch) {
+                    const val = itemMatch[1].replace(/^["']|["']$/g, "");
+                    result[currentKey].push(val);
+                }
+            }
+            else if (currentMode === "folded") {
+                foldedLines.push(trimmed);
+            }
+            continue;
+        }
+        // Non-indented non-key line (blank line) — flush folded
+        if (line.trim() === "") {
+            if (currentMode === "folded") {
+                // Continue collecting — blank lines are paragraph breaks in folded
+            }
+        }
+    }
+    // Flush any remaining folded content
+    flushFolded();
+    return result;
+}
+/**
+ * Validate a parsed skill object against the Core skill schema.
+ *
+ * Returns `{ valid: true, errors: [], skill }` on success, or
+ * `{ valid: false, errors: [...], skill: null }` with descriptive
+ * error messages for each violation.
+ *
+ * @example
+ * ```ts
+ * const result = validateSkill({ name: "my-skill", description: "Does stuff" });
+ * // { valid: false, errors: ["Missing required field: tools", ...], skill: null }
+ * ```
+ */
+export function validateSkill(data) {
+    const errors = [];
+    // Check required fields exist
+    for (const field of REQUIRED_FIELDS) {
+        if (!(field in data) || data[field] === undefined || data[field] === "") {
+            errors.push(`Missing required field: ${field}`);
+        }
+    }
+    // Warn on unknown fields
+    for (const key of Object.keys(data)) {
+        if (!ALL_KNOWN_FIELDS.has(key)) {
+            errors.push(`Unknown field: ${key}`);
+        }
+    }
+    // Type checks for present fields
+    if (typeof data.name === "string") {
+        if (!NAME_PATTERN.test(data.name)) {
+            errors.push(`Invalid name: "${data.name}" — must be kebab-case (lowercase letters, digits, hyphens, starting with a letter)`);
+        }
+    }
+    else if ("name" in data) {
+        errors.push(`Field "name" must be a string, got ${typeof data.name}`);
+    }
+    if ("description" in data && typeof data.description === "string") {
+        if (data.description.length < 10) {
+            errors.push(`Field "description" is too short (${data.description.length} chars, minimum 10)`);
+        }
+    }
+    else if ("description" in data) {
+        errors.push(`Field "description" must be a string, got ${typeof data.description}`);
+    }
+    if ("example_prompt" in data && typeof data.example_prompt === "string") {
+        if (data.example_prompt.length < 10) {
+            errors.push(`Field "example_prompt" is too short (${data.example_prompt.length} chars, minimum 10)`);
+        }
+    }
+    else if ("example_prompt" in data) {
+        errors.push(`Field "example_prompt" must be a string, got ${typeof data.example_prompt}`);
+    }
+    // Array field checks
+    for (const field of ARRAY_FIELDS) {
+        if (!(field in data))
+            continue;
+        const value = data[field];
+        if (!Array.isArray(value)) {
+            errors.push(`Field "${field}" must be an array, got ${typeof value}`);
+            continue;
+        }
+        if (!value.every((item) => typeof item === "string")) {
+            errors.push(`Field "${field}" must contain only strings`);
+            continue;
+        }
+        // Required arrays need at least one item
+        if ((field === "tools" || field === "context_patterns") &&
+            value.length === 0) {
+            errors.push(`Field "${field}" must have at least one item`);
+        }
+    }
+    // Optional string fields
+    for (const field of ["version", "notes"]) {
+        if (field in data && typeof data[field] !== "string") {
+            errors.push(`Field "${field}" must be a string, got ${typeof data[field]}`);
+        }
+    }
+    if (errors.length > 0) {
+        return { valid: false, errors, skill: null };
+    }
+    return {
+        valid: true,
+        errors: [],
+        skill: data,
+    };
+}
+/**
+ * Read and validate a skill YAML file from disk.
+ *
+ * Combines parsing and validation in one step. Returns the validated
+ * skill definition or a list of errors.
+ *
+ * @example
+ * ```ts
+ * const result = await validateSkillFile("brain/skills/file-editing.yml");
+ * if (result.valid) {
+ *   console.log(`Loaded skill: ${result.skill!.name}`);
+ *   console.log(`Tools: ${result.skill!.tools.join(", ")}`);
+ * } else {
+ *   for (const err of result.errors) console.error(`  - ${err}`);
+ * }
+ * ```
+ */
+export async function validateSkillFile(filePath) {
+    let content;
+    try {
+        content = await readFile(filePath, "utf-8");
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : "Unknown read error";
+        return {
+            valid: false,
+            errors: [`Failed to read file: ${message}`],
+            skill: null,
+        };
+    }
+    const parsed = parseSkillYaml(content);
+    return validateSkill(parsed);
+}
+// ---------------------------------------------------------------------------
+// SkillRegistry
+// ---------------------------------------------------------------------------
+/**
+ * Registry for YAML-based brain skills (`brain/skills/*.yml`).
+ *
+ * Loads skill definitions from disk, validates them against the schema,
+ * and provides context-aware matching and prompt formatting for agent
+ * injection.
+ */
+export class SkillRegistry {
+    skillsDir;
+    skills = new Map();
+    loaded = false;
+    constructor(skillsDir) {
+        this.skillsDir = skillsDir;
+    }
+    /**
+     * Load all `.yml` skill files from the skills directory.
+     * Validates each against the schema and registers valid skills.
+     * Skips `schema.yml` itself. Safe to call multiple times — clears
+     * and reloads on subsequent calls.
+     */
+    async loadSkills() {
+        this.skills.clear();
+        let files;
+        try {
+            files = await readdir(this.skillsDir);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.debug(`[brain/skills] Cannot read ${this.skillsDir}: ${message}`);
+            this.loaded = true;
+            return;
+        }
+        const ymlFiles = files.filter((f) => f.endsWith(".yml") && f !== "schema.yml");
+        const results = await Promise.allSettled(ymlFiles.map((f) => readFile(join(this.skillsDir, f), "utf-8")));
+        for (let i = 0; i < ymlFiles.length; i++) {
+            const result = results[i];
+            if (result.status !== "fulfilled") {
+                console.debug(`[brain/skills] Failed to read ${ymlFiles[i]}`);
+                continue;
+            }
+            const parsed = parseSkillYaml(result.value);
+            const validation = validateSkill(parsed);
+            if (!validation.valid) {
+                console.debug(`[brain/skills] Invalid ${ymlFiles[i]}: ${validation.errors.join("; ")}`);
+                continue;
+            }
+            this.skills.set(validation.skill.name, validation.skill);
+        }
+        this.loaded = true;
+        console.debug(`[brain/skills] Loaded ${this.skills.size} skill(s) from ${this.skillsDir}`);
+    }
+    /**
+     * Match skills against a task context.
+     *
+     * Scores each skill by checking its `context_patterns` against the
+     * provided file paths (glob-style prefix/suffix matching) and content
+     * keywords (case-insensitive substring matching).
+     *
+     * Returns matches sorted by score descending. Skills with no matches
+     * are excluded.
+     */
+    matchSkills(context) {
+        this.ensureLoaded();
+        const matches = [];
+        const contentLower = context.content?.toLowerCase() ?? "";
+        const normalizedPaths = (context.filePaths ?? []).map((p) => p.replace(/\\/g, "/"));
+        for (const skill of this.skills.values()) {
+            const matchedPatterns = [];
+            for (const pattern of skill.context_patterns) {
+                // Check against file paths
+                if (normalizedPaths.length > 0 && this.patternMatchesPaths(pattern, normalizedPaths)) {
+                    matchedPatterns.push(pattern);
+                    continue;
+                }
+                // Check against content (keyword / substring match)
+                if (contentLower && contentLower.includes(pattern.toLowerCase())) {
+                    matchedPatterns.push(pattern);
+                }
+            }
+            if (matchedPatterns.length > 0) {
+                const score = Math.min(1.0, matchedPatterns.length / skill.context_patterns.length);
+                matches.push({ skill, score, matchedPatterns });
+            }
+        }
+        matches.sort((a, b) => b.score - a.score);
+        return matches;
+    }
+    /**
+     * Format a skill for injection into an agent prompt.
+     *
+     * Returns a structured block with the skill name, description, tools,
+     * example prompt, and notes — ready for inclusion in an LLM system
+     * message. Returns null if the skill is not found.
+     */
+    getSkillPrompt(skillName) {
+        this.ensureLoaded();
+        const skill = this.skills.get(skillName);
+        if (!skill)
+            return null;
+        const lines = [
+            `<skill name="${skill.name}">`,
+            `## ${skill.name}`,
+            "",
+            `> ${skill.description.trim()}`,
+            "",
+            `**Tools:** ${skill.tools.join(", ")}`,
+            "",
+            `**Example prompt:**`,
+            skill.example_prompt.trim(),
+        ];
+        if (skill.tags && skill.tags.length > 0) {
+            lines.push("", `**Tags:** ${skill.tags.join(", ")}`);
+        }
+        if (skill.notes) {
+            lines.push("", `**Notes:**`, skill.notes.trim());
+        }
+        if (skill.depends_on && skill.depends_on.length > 0) {
+            lines.push("", `**Depends on:** ${skill.depends_on.join(", ")}`);
+        }
+        lines.push("</skill>");
+        return lines.join("\n");
+    }
+    /** Get a skill by name. */
+    get(name) {
+        this.ensureLoaded();
+        return this.skills.get(name);
+    }
+    /** Check if a skill is registered. */
+    has(name) {
+        this.ensureLoaded();
+        return this.skills.has(name);
+    }
+    /** List all loaded skill names. */
+    list() {
+        this.ensureLoaded();
+        return Array.from(this.skills.keys());
+    }
+    /** Total number of loaded skills. */
+    get size() {
+        return this.skills.size;
+    }
+    // -------------------------------------------------------------------------
+    // Internal
+    // -------------------------------------------------------------------------
+    /**
+     * Check whether a context_pattern matches any of the given file paths.
+     *
+     * Supports:
+     *  - Extension patterns (`*.ts`, `*.yml`) — matches file suffix
+     *  - Directory patterns (`src/`, `logs/`) — matches path containing the dir
+     *  - Exact filenames (`CHANGELOG.md`) — matches basename or full path
+     */
+    patternMatchesPaths(pattern, paths) {
+        if (pattern.startsWith("*.")) {
+            // Extension match: *.ts, *.log, *.yml
+            const ext = pattern.slice(1); // ".ts", ".log"
+            return paths.some((p) => p.endsWith(ext));
+        }
+        if (pattern.endsWith("/")) {
+            // Directory match: src/, logs/, __tests__/
+            return paths.some((p) => p.includes(pattern) || p.includes(pattern.slice(0, -1)));
+        }
+        if (pattern.includes("/") || pattern.includes(".")) {
+            // Path or filename match: CHANGELOG.md, vitest.config.*
+            if (pattern.includes("*")) {
+                // Glob-like: vitest.config.*
+                const prefix = pattern.split("*")[0];
+                return paths.some((p) => p.includes(prefix));
+            }
+            return paths.some((p) => p.includes(pattern));
+        }
+        // Bare keyword — doesn't match paths, only content
+        return false;
+    }
+    /** Throw if loadSkills() hasn't been called yet. */
+    ensureLoaded() {
+        if (!this.loaded) {
+            throw new Error("SkillRegistry not loaded. Call loadSkills() before using the registry.");
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Singleton
+// ---------------------------------------------------------------------------
+/** Pre-configured singleton for `brain/skills/`. */
+export const brainSkillRegistry = new SkillRegistry("brain/skills");
+//# sourceMappingURL=skills.js.map

package/dist/brain/skills.js.map

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

package/dist/brain.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Brain — orchestrator for Core: memory + context assembly + retrieval.
+ * Implements the "brain" layer: internal actions (retrieve, learn) and context assembly.
+ */
+import type { BrainConfig, GetContextOptions, GetContextResult, LearnInput, MemoryEntry, WorkingMemory } from "./types.js";
+import type { LongTermMemoryStore } from "./memory/long-term.js";
+export declare class Brain {
+    private readonly config;
+    private readonly ltm;
+    private workingMemory;
+    constructor(config: BrainConfig, ltm?: LongTermMemoryStore);
+    /**
+     * Internal action: retrieve from LTM into working memory.
+     * Called automatically in getContextForTurn; can also be called explicitly.
+     */
+    retrieve(query: string, options?: {
+        max?: number;
+        type?: "episodic" | "semantic" | "procedural";
+    }): Promise<MemoryEntry[]>;
+    /**
+     * Assemble full context for this turn: retrieve, build sections, return messages + working memory.
+     */
+    getContextForTurn(options: GetContextOptions): Promise<GetContextResult>;
+    /**
+     * Internal action: learn — write to long-term memory.
+     */
+    learn(input: LearnInput): Promise<MemoryEntry>;
+    /**
+     * Update working memory with the latest thought (e.g. after LLM reasoning).
+     * Call this after the model returns a "thought" or reasoning block if you use ReAct-style loops.
+     */
+    setLastThought(thought: string): void;
+    /**
+     * Clear working memory retrieved items and optional scratch (e.g. for a new task or turn).
+     */
+    clearWorkingMemory(clearScratch?: boolean): void;
+    /** Access current working memory (read-only). */
+    getWorkingMemory(): Readonly<WorkingMemory>;
+    /** Access LTM for advanced use (e.g. list, delete). */
+    getLongTermMemory(): LongTermMemoryStore;
+}
+//# sourceMappingURL=brain.d.ts.map

package/dist/brain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../src/brain.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3H,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAKjE,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAsB;IAC1C,OAAO,CAAC,aAAa,CAAgB;gBAEzB,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,mBAAmB;IAS1D;;;OAGG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,YAAY,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAahI;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA4B9E;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IASpD;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIrC;;OAEG;IACH,kBAAkB,CAAC,YAAY,UAAQ,GAAG,IAAI;IAQ9C,iDAAiD;IACjD,gBAAgB,IAAI,QAAQ,CAAC,aAAa,CAAC;IAI3C,uDAAuD;IACvD,iBAAiB,IAAI,mBAAmB;CAGzC"}

package/dist/brain.js

@@ -0,0 +1,98 @@
+/**
+ * Brain — orchestrator for Core: memory + context assembly + retrieval.
+ * Implements the "brain" layer: internal actions (retrieve, learn) and context assembly.
+ */
+import { InMemoryLongTermMemory } from "./memory/long-term.js";
+import { createWorkingMemory, updateWorkingMemory } from "./memory/working.js";
+import { assembleSections, sectionsToMessages } from "./context/assembler.js";
+export class Brain {
+    config;
+    ltm;
+    workingMemory;
+    constructor(config, ltm) {
+        this.config = {
+            maxRetrieved: 10,
+            ...config,
+        };
+        this.ltm = ltm ?? new InMemoryLongTermMemory();
+        this.workingMemory = createWorkingMemory();
+    }
+    /**
+     * Internal action: retrieve from LTM into working memory.
+     * Called automatically in getContextForTurn; can also be called explicitly.
+     */
+    async retrieve(query, options) {
+        const max = options?.max ?? this.config.maxRetrieved ?? 10;
+        const entries = await this.ltm.search({
+            contentSubstring: query,
+            type: options?.type,
+        });
+        const selected = entries.slice(0, max);
+        this.workingMemory = updateWorkingMemory(this.workingMemory, {
+            retrieved: selected,
+        });
+        return selected;
+    }
+    /**
+     * Assemble full context for this turn: retrieve, build sections, return messages + working memory.
+     */
+    async getContextForTurn(options) {
+        const retrievalQuery = options.retrievalQuery ?? options.userInput;
+        const maxRetrieved = options.maxRetrieved ?? this.config.maxRetrieved ?? 10;
+        // Internal action: retrieve into working memory
+        await this.retrieve(retrievalQuery, { max: maxRetrieved });
+        this.workingMemory = updateWorkingMemory(this.workingMemory, {
+            perceptualInput: options.userInput,
+            activeGoal: options.userInput,
+        });
+        const sections = assembleSections(this.workingMemory, options, {
+            systemPrompt: this.config.systemPrompt,
+            defaultInstructions: this.config.defaultInstructions,
+            defaultCues: this.config.defaultCues,
+            maxSupportingTokens: this.config.maxSupportingTokens,
+        });
+        const messages = sectionsToMessages(sections, options.conversationHistory ?? []);
+        return {
+            messages,
+            sections,
+            workingMemory: this.workingMemory,
+        };
+    }
+    /**
+     * Internal action: learn — write to long-term memory.
+     */
+    async learn(input) {
+        const entry = await this.ltm.add({
+            type: input.type,
+            content: input.content,
+            meta: input.meta,
+        });
+        return entry;
+    }
+    /**
+     * Update working memory with the latest thought (e.g. after LLM reasoning).
+     * Call this after the model returns a "thought" or reasoning block if you use ReAct-style loops.
+     */
+    setLastThought(thought) {
+        this.workingMemory = updateWorkingMemory(this.workingMemory, { lastThought: thought });
+    }
+    /**
+     * Clear working memory retrieved items and optional scratch (e.g. for a new task or turn).
+     */
+    clearWorkingMemory(clearScratch = false) {
+        this.workingMemory = updateWorkingMemory(this.workingMemory, {
+            retrieved: [],
+            lastThought: undefined,
+            scratch: clearScratch ? {} : this.workingMemory.scratch,
+        });
+    }
+    /** Access current working memory (read-only). */
+    getWorkingMemory() {
+        return this.workingMemory;
+    }
+    /** Access LTM for advanced use (e.g. list, delete). */
+    getLongTermMemory() {
+        return this.ltm;
+    }
+}
+//# sourceMappingURL=brain.js.map

package/dist/brain.js.map

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

package/dist/browser/sessions.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Browser session manager — persist and reuse Playwright storageState per domain.
+ *
+ * Sessions are stored as AES-256-GCM encrypted JSON in brain/browser/sessions/.
+ * Each session is keyed by domain with a 7-day expiry.
+ */
+/**
+ * Save a Playwright storageState (cookies, localStorage, etc.) for a domain.
+ */
+export declare function saveSession(domain: string, storageState: unknown): Promise<void>;
+/**
+ * Load a stored session for a domain, or null if missing/expired/corrupted.
+ */
+export declare function loadSession(domain: string): Promise<unknown | null>;
+/**
+ * Delete a stored session for a domain.
+ */
+export declare function deleteSession(domain: string): Promise<void>;
+/**
+ * Purge all expired sessions from disk.
+ */
+export declare function purgeExpiredSessions(): Promise<number>;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/browser/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/browser/sessions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgEH;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAetF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAiBzE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,CAqB5D"}