@hy-sde-org/dsh-tool-debug 0.1.1-rc.2

package/dist/render.js

@@ -0,0 +1,524 @@
+/**
+ * Result formatting for the `debug` tool: one closed JSON output shape, the
+ * schema that declares it, and pure formatters that project it into
+ * model-facing text. All formatters are bounded by `maxResultChars`.
+ * Formatting ported from oh-my-pi's `tools/debug.ts` (MIT) and adapted to the
+ * DSH tool-output contract.
+ * @module @hy-sde-org/dsh-tool-debug/render
+ */
+export { DEBUG_ACTIONS, isDebugAction, DEBUG_READONLY_ACTIONS } from "./types.js";
+/** Cap on the total length of any rendered result. */
+export const DEFAULT_MAX_RESULT_CHARS = 16_000;
+/**
+ * Project a DAP session summary into the canonical plain record.
+ * @param snapshot - the DAP session summary.
+ * @returns the projected plain session record.
+ */
+export function projectSession(snapshot) {
+    const record = {};
+    if (snapshot.id !== undefined)
+        record.id = snapshot.id;
+    if (snapshot.adapter !== undefined)
+        record.adapter = snapshot.adapter;
+    if (snapshot.cwd !== undefined)
+        record.cwd = snapshot.cwd;
+    if (snapshot.program !== undefined)
+        record.program = snapshot.program;
+    if (snapshot.status !== undefined)
+        record.status = snapshot.status;
+    if (snapshot.stopReason !== undefined)
+        record.stopReason = snapshot.stopReason;
+    if (snapshot.frameName !== undefined)
+        record.frameName = snapshot.frameName;
+    if (snapshot.line !== undefined)
+        record.line = snapshot.line;
+    if (snapshot.source?.path !== undefined)
+        record.sourcePath = snapshot.source.path;
+    if (snapshot.instructionPointerReference !== undefined) {
+        record.instructionPointerReference = snapshot.instructionPointerReference;
+    }
+    if (snapshot.needsConfigurationDone !== undefined) {
+        record.needsConfigurationDone = snapshot.needsConfigurationDone;
+    }
+    if (snapshot.exitCode !== undefined)
+        record.exitCode = snapshot.exitCode;
+    return record;
+}
+/** Bounded text: truncate long renderings to `maxResultChars` with a note. */
+function truncate(text, maxResultChars) {
+    if (text.length <= maxResultChars)
+        return text;
+    return `${text.slice(0, maxResultChars)}\n… (truncated)`;
+}
+/**
+ * Format the primary stop location of a session snapshot.
+ * @param snapshot - the session snapshot.
+ * @returns a `path:line:column` string, or null when the location is unknown.
+ */
+export function formatLocation(snapshot) {
+    if (!snapshot?.source?.path || snapshot.line === undefined) {
+        return null;
+    }
+    return `${snapshot.source.path}:${snapshot.line}${snapshot.column !== undefined ? `:${snapshot.column}` : ''}`;
+}
+/**
+ * Format one session snapshot into human-readable lines.
+ * @param snapshot - the session snapshot.
+ * @returns the rendered lines.
+ */
+export function formatSessionSnapshot(snapshot) {
+    const lines = [
+        `Session ${snapshot.id}`,
+        `Adapter: ${snapshot.adapter}`,
+        `Status: ${snapshot.status}`,
+        `CWD: ${snapshot.cwd}`,
+    ];
+    if (snapshot.program)
+        lines.push(`Program: ${snapshot.program}`);
+    if (snapshot.stopReason)
+        lines.push(`Stop reason: ${snapshot.stopReason}`);
+    if (snapshot.frameName)
+        lines.push(`Frame: ${snapshot.frameName}`);
+    if (snapshot.instructionPointerReference) {
+        lines.push(`Instruction pointer: ${snapshot.instructionPointerReference}`);
+    }
+    const location = formatLocation(snapshot);
+    if (location)
+        lines.push(`Location: ${location}`);
+    if (snapshot.needsConfigurationDone) {
+        lines.push('Configuration: pending configurationDone; set breakpoints, then continue.');
+    }
+    if (snapshot.exitCode !== undefined)
+        lines.push(`Exit code: ${snapshot.exitCode}`);
+    return lines;
+}
+/**
+ * Format source breakpoints registered for a file.
+ * @param filePath - the source file path.
+ * @param breakpoints - the source breakpoint records.
+ * @returns the rendered breakpoint text.
+ */
+export function formatBreakpoints(filePath, breakpoints) {
+    const lines = [`Breakpoints for ${filePath}:`];
+    if (breakpoints.length === 0) {
+        lines.push('(none)');
+        return lines.join('\n');
+    }
+    for (const breakpoint of breakpoints) {
+        lines.push(`- line ${breakpoint.line}: ${breakpoint.verified ? 'verified' : 'pending'}${breakpoint.condition ? ` if ${breakpoint.condition}` : ''}${breakpoint.message ? ` (${breakpoint.message})` : ''}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format function breakpoints registered for the session.
+ * @param breakpoints - the function breakpoint records.
+ * @returns the rendered breakpoint text.
+ */
+export function formatFunctionBreakpoints(breakpoints) {
+    const lines = ['Function breakpoints:'];
+    if (breakpoints.length === 0) {
+        lines.push('(none)');
+        return lines.join('\n');
+    }
+    for (const breakpoint of breakpoints) {
+        lines.push(`- ${breakpoint.name}: ${breakpoint.verified ? 'verified' : 'pending'}${breakpoint.condition ? ` if ${breakpoint.condition}` : ''}${breakpoint.message ? ` (${breakpoint.message})` : ''}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format the current stack frames.
+ * @param frames - the stack frames.
+ * @returns the rendered stack trace text.
+ */
+export function formatStackFrames(frames) {
+    const lines = ['Stack trace:'];
+    if (frames.length === 0) {
+        lines.push('(empty)');
+        return lines.join('\n');
+    }
+    for (const frame of frames) {
+        const location = frame.source?.path
+            ? `${frame.source.path}:${frame.line}:${frame.column}`
+            : `<unknown>:${frame.line}:${frame.column}`;
+        lines.push(`- #${frame.id} ${frame.name} @ ${location}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format the debuggee's threads.
+ * @param threads - the DAP threads.
+ * @returns the rendered thread list text.
+ */
+export function formatThreads(threads) {
+    const lines = ['Threads:'];
+    if (threads.length === 0) {
+        lines.push('(none)');
+        return lines.join('\n');
+    }
+    for (const thread of threads) {
+        lines.push(`- ${thread.id}: ${thread.name}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format the scopes of a stack frame.
+ * @param scopes - the DAP scopes.
+ * @returns the rendered scope list text.
+ */
+export function formatScopes(scopes) {
+    const lines = ['Scopes:'];
+    if (scopes.length === 0) {
+        lines.push('(none)');
+        return lines.join('\n');
+    }
+    for (const scope of scopes) {
+        lines.push(`- ${scope.name}: ref=${scope.variablesReference}, expensive=${scope.expensive ? 'yes' : 'no'}${scope.presentationHint ? `, hint=${scope.presentationHint}` : ''}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format the variables of a variable reference.
+ * @param variables - the DAP variables.
+ * @returns the rendered variable list text.
+ */
+export function formatVariables(variables) {
+    const lines = ['Variables:'];
+    if (variables.length === 0) {
+        lines.push('(none)');
+        return lines.join('\n');
+    }
+    for (const variable of variables) {
+        lines.push(`- ${variable.name} = ${variable.value}${variable.type ? ` (${variable.type})` : ''}${variable.variablesReference > 0 ? ` [ref=${variable.variablesReference}]` : ''}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format a source label, optionally with line and column.
+ * @param source - the DAP source, or undefined.
+ * @param line - optional source line.
+ * @param column - optional source column.
+ * @returns the formatted `base:line:column` label, or null when unknown.
+ */
+export function formatSourceLabel(source, line, column) {
+    if (!source?.path && !source?.name) {
+        return null;
+    }
+    const base = source.path ?? source.name ?? '<unknown>';
+    if (line === undefined) {
+        return base;
+    }
+    return `${base}:${line}${column !== undefined ? `:${column}` : ''}`;
+}
+/**
+ * Format disassembled instructions.
+ * @param instructions - the disassembled instructions.
+ * @returns the rendered disassembly text.
+ */
+export function formatDisassembly(instructions) {
+    const lines = ['Disassembly:'];
+    if (instructions.length === 0) {
+        lines.push('(empty)');
+        return lines.join('\n');
+    }
+    const addressWidth = Math.max(...instructions.map(instruction => instruction.address.length));
+    const bytesWidth = Math.max(...instructions.map(instruction => instruction.instructionBytes?.length ?? 0), 2);
+    for (const instruction of instructions) {
+        const location = formatSourceLabel(instruction.location, instruction.line, instruction.column);
+        const parts = [
+            instruction.address.padEnd(addressWidth),
+            (instruction.instructionBytes ?? '').padEnd(bytesWidth),
+            instruction.instruction,
+        ];
+        if (instruction.symbol) {
+            parts.push(`<${instruction.symbol}>`);
+        }
+        if (location) {
+            parts.push(`[${location}]`);
+        }
+        lines.push(parts
+            .filter(part => part.length > 0)
+            .join('  ')
+            .trimEnd());
+    }
+    return lines.join('\n');
+}
+/**
+ * Format a memory read result as a hex/ascii dump.
+ * @param address - the memory address read.
+ * @param data - the base64-encoded buffer string, or undefined.
+ * @param unreadableBytes - optional count of unreadable bytes.
+ * @returns the rendered memory dump text.
+ */
+export function formatMemoryRead(address, data, unreadableBytes) {
+    const lines = [`Memory at ${address}:`];
+    const buffer = data ? Buffer.from(data, 'base64') : Buffer.alloc(0);
+    if (buffer.length === 0) {
+        lines.push('(no readable bytes)');
+    }
+    else {
+        for (let offset = 0; offset < buffer.length; offset += 16) {
+            const chunk = buffer.subarray(offset, offset + 16);
+            const hex = Array.from(chunk, byte => byte.toString(16).padStart(2, '0')).join(' ');
+            const ascii = Array.from(chunk, byte => (byte >= 32 && byte < 127 ? String.fromCharCode(byte) : '.')).join('');
+            lines.push(`${(offset === 0 ? address : `+0x${offset.toString(16)}`).padEnd(18)} ${hex.padEnd(47)} |${ascii}|`);
+        }
+    }
+    if (unreadableBytes !== undefined && unreadableBytes > 0) {
+        lines.push(`Unreadable bytes: ${unreadableBytes}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Render a simple aligned text table.
+ * @param headers - the column headers.
+ * @param rows - the table rows.
+ * @returns the rendered table text.
+ */
+export function formatTable(headers, rows) {
+    const widths = headers.map((header, index) => Math.max(header.length, ...rows.map(row => (row[index] ?? '').length)));
+    const formatRow = (row) => row.map((cell, index) => (cell ?? '').padEnd(widths[index] ?? 0)).join('  ');
+    return [formatRow(headers), formatRow(widths.map(width => '-'.repeat(width ?? 0))), ...rows.map(formatRow)].join('\n');
+}
+/**
+ * Format loaded modules of the debuggee as a table.
+ * @param modules - the DAP modules.
+ * @returns the rendered module table text.
+ */
+export function formatModules(modules) {
+    if (modules.length === 0) {
+        return 'Modules:\n(none)';
+    }
+    return [
+        'Modules:',
+        formatTable(['ID', 'Name', 'Path', 'Symbols', 'Range'], modules.map(module => [
+            String(module.id),
+            module.name,
+            module.path ?? '',
+            module.symbolStatus ?? '',
+            module.addressRange ?? '',
+        ])),
+    ].join('\n');
+}
+/**
+ * Format source files loaded by the debuggee.
+ * @param sources - the DAP sources.
+ * @returns the rendered loaded-sources text.
+ */
+export function formatLoadedSources(sources) {
+    const lines = ['Loaded sources:'];
+    if (sources.length === 0) {
+        lines.push('(none)');
+        return lines.join('\n');
+    }
+    for (const source of sources) {
+        const label = source.path ?? source.name ?? '<unknown>';
+        lines.push(`- ${label}${source.sourceReference !== undefined ? ` [ref=${source.sourceReference}]` : ''}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format instruction breakpoints.
+ * @param breakpoints - the instruction breakpoint records.
+ * @returns the rendered breakpoint text.
+ */
+export function formatInstructionBreakpoints(breakpoints) {
+    const lines = ['Instruction breakpoints:'];
+    if (breakpoints.length === 0) {
+        lines.push('(none)');
+        return lines.join('\n');
+    }
+    for (const breakpoint of breakpoints) {
+        const location = `${breakpoint.instructionReference}${breakpoint.offset !== undefined ? `+${breakpoint.offset}` : ''}`;
+        lines.push(`- ${location}: ${breakpoint.verified ? 'verified' : 'pending'}${breakpoint.condition ? ` if ${breakpoint.condition}` : ''}${breakpoint.hitCondition ? ` after ${breakpoint.hitCondition}` : ''}${breakpoint.message ? ` (${breakpoint.message})` : ''}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format data-breakpoint availability info.
+ * @param info - the data-breakpoint info response.
+ * @returns the rendered info text.
+ */
+export function formatDataBreakpointInfo(info) {
+    const lines = [`Data breakpoint info: ${info.description}`];
+    lines.push(`Data ID: ${info.dataId ?? '(not available)'}`);
+    if (info.accessTypes && info.accessTypes.length > 0) {
+        lines.push(`Access types: ${info.accessTypes.join(', ')}`);
+    }
+    if (info.canPersist !== undefined) {
+        lines.push(`Persistent: ${info.canPersist ? 'yes' : 'no'}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format data breakpoints.
+ * @param breakpoints - the data breakpoint records.
+ * @returns the rendered breakpoint text.
+ */
+export function formatDataBreakpoints(breakpoints) {
+    const lines = ['Data breakpoints:'];
+    if (breakpoints.length === 0) {
+        lines.push('(none)');
+        return lines.join('\n');
+    }
+    for (const breakpoint of breakpoints) {
+        lines.push(`- ${breakpoint.dataId}: ${breakpoint.verified ? 'verified' : 'pending'}${breakpoint.accessType ? ` (${breakpoint.accessType})` : ''}${breakpoint.condition ? ` if ${breakpoint.condition}` : ''}${breakpoint.hitCondition ? ` after ${breakpoint.hitCondition}` : ''}${breakpoint.message ? ` (${breakpoint.message})` : ''}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format a custom DAP request response.
+ * @param command - the custom request command name.
+ * @param body - the response body.
+ * @returns the rendered serialized response text.
+ */
+export function formatCustomResponse(command, body) {
+    let serialized = '';
+    try {
+        serialized = JSON.stringify(body, null, 2) ?? 'null';
+    }
+    catch {
+        serialized = String(body);
+    }
+    return `${command} response:\n${serialized}`;
+}
+/**
+ * Format all sessions under the manager.
+ * @param sessions - the session summaries.
+ * @returns the rendered session list text.
+ */
+export function formatSessions(sessions) {
+    if (sessions.length === 0) {
+        return 'No debug sessions.';
+    }
+    return sessions
+        .map((session) => {
+        const location = formatLocation(session);
+        return [
+            `${session.id}: ${session.status}`,
+            `  adapter=${session.adapter}`,
+            `  cwd=${session.cwd}`,
+            ...(session.program ? [`  program=${session.program}`] : []),
+            ...(location ? [`  location=${location}`] : []),
+            ...(session.stopReason ? [`  reason=${session.stopReason}`] : []),
+        ].join('\n');
+    })
+        .join('\n\n');
+}
+/**
+ * Format an evaluation result.
+ * @param evaluation - the picked evaluation fields.
+ * @returns the rendered evaluation text.
+ */
+export function formatEvaluation(evaluation) {
+    const lines = [`Result: ${evaluation.result}`];
+    if (evaluation.type)
+        lines.push(`Type: ${evaluation.type}`);
+    if (evaluation.variablesReference > 0) {
+        lines.push(`Variables ref: ${evaluation.variablesReference}`);
+    }
+    return lines.join('\n');
+}
+/** Canonical session-record property specs (all optional on purpose). */
+const SESSION_PROPERTIES = {
+    id: { type: 'string' },
+    adapter: { type: 'string' },
+    cwd: { type: 'string' },
+    program: { type: 'string' },
+    status: { type: 'string' },
+    stopReason: { type: 'string' },
+    frameName: { type: 'string' },
+    line: { type: 'number' },
+    sourcePath: { type: 'string' },
+    instructionPointerReference: { type: 'string' },
+    needsConfigurationDone: { type: 'boolean' },
+    exitCode: { type: 'number' },
+};
+/** Schema declaring the closed `debug` tool output value shape. */
+export const DEBUG_OUTPUT_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        action: { type: 'string', required: true },
+        success: { type: 'boolean', required: true },
+        message: { type: 'string', required: true },
+        session: {
+            type: 'object',
+            additionalProperties: false,
+            properties: SESSION_PROPERTIES,
+        },
+        sessions: {
+            type: 'array',
+            items: { type: 'object', additionalProperties: false, properties: SESSION_PROPERTIES },
+        },
+        state: { type: 'string' },
+        timedOut: { type: 'boolean' },
+        output: { type: 'string' },
+    },
+};
+/**
+ * Compose a message from the durable value; callers pre-set `message`.
+ * @param _args - the debug tool arguments (unused).
+ * @param value - the durable tool output value.
+ * @returns the message text.
+ */
+export function renderDebugCall(_args, value) {
+    return value.message ?? '(no output)';
+}
+/**
+ * Deterministic one-line summary of a `debug` call for UIs.
+ * @param args - the debug tool arguments.
+ * @returns the one-line summary text.
+ */
+export function summarizeDebugCall(args) {
+    const action = args.action ? args.action.replaceAll('_', ' ') : 'request';
+    if (args.program)
+        return `${action} ${args.program}`;
+    if (args.file && args.line !== undefined)
+        return `${action} ${args.file}:${args.line}`;
+    if (args.function)
+        return `${action} ${args.function}`;
+    if (args.expression)
+        return `${action} ${args.expression}`;
+    if (args.command)
+        return `${action} ${args.command}`;
+    if (args.memory_reference)
+        return `${action} ${args.memory_reference}`;
+    if (args.instruction_reference)
+        return `${action} ${args.instruction_reference}`;
+    if (args.data_id)
+        return `${action} ${args.data_id}`;
+    if (args.name)
+        return `${action} ${args.name}`;
+    return action;
+}
+/**
+ * Pure, side-effect-free pending-call view for UIs (softly typed for replay).
+ * @param args - the debug tool arguments.
+ * @returns the generic pending-call view.
+ */
+export function presentDebugCall(args) {
+    const action = args.action ?? 'request';
+    return {
+        card: 'generic',
+        title: `debug ${action}`,
+        kind: 'execute',
+        rawInput: { action: args.action, program: args.program },
+    };
+}
+/**
+ * Project a rendered result into a {message} + detail value.
+ * @param action - the debug action performed.
+ * @param text - the rendered result text.
+ * @param extra - additional fields to include in the output value.
+ * @param maxResultChars - cap on the total rendered message length.
+ * @returns the constructed tool output value.
+ */
+export function makeDebugOutput(action, text, extra, maxResultChars) {
+    return {
+        action,
+        success: true,
+        message: truncate(text, maxResultChars),
+        ...extra,
+    };
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Derive the workspace root a `debug` call resolves paths against: the calling
+ * agent's per-session workspace (`exec.agent.session.header.cwd`), mirroring
+ * the filesystem and LSP tools. When a call supplies an explicit `cwd`, paths
+ * are resolved against that instead (still relative to the session workspace
+ * when `cwd` itself is relative).
+ * @module @hy-sde-org/dsh-tool-debug/session
+ */
+import type { ToolExecution } from '@deepseek-ai/dsh-tools';
+/**
+ * The session workspace cwd for this call, or `undefined` when none applies.
+ * @param exec - the tool-execution context; only its optional `agent` is read.
+ * @returns the calling agent's session cwd, or undefined for a non-agent caller.
+ */
+export declare function sessionCwd(exec: ToolExecution): string | undefined;
+/**
+ * Resolve a user-supplied path against the session workspace (absolute paths
+ * pass through; relative paths join `base`).
+ * @param input - the path as the model provided it.
+ * @param base - the resolution root (session cwd or an explicit call cwd).
+ * @returns the resolved absolute path.
+ */
+export declare function resolveToCwd(input: string, base: string): string;
+/**
+ * The effective working directory for one call: the explicit `cwd` arg when
+ * present (absolute, or joined onto the session cwd), else the session cwd.
+ * @param args - parsed call arguments.
+ * @param workspace - the session workspace cwd (required).
+ * @returns the resolved call working directory.
+ */
+export declare function resolveCallCwd(args: {
+    readonly cwd?: string;
+}, workspace: string): string;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAE3D;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAElE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGzF"}

package/dist/session.js

@@ -0,0 +1,40 @@
+/**
+ * Derive the workspace root a `debug` call resolves paths against: the calling
+ * agent's per-session workspace (`exec.agent.session.header.cwd`), mirroring
+ * the filesystem and LSP tools. When a call supplies an explicit `cwd`, paths
+ * are resolved against that instead (still relative to the session workspace
+ * when `cwd` itself is relative).
+ * @module @hy-sde-org/dsh-tool-debug/session
+ */
+import * as path from 'node:path';
+/**
+ * The session workspace cwd for this call, or `undefined` when none applies.
+ * @param exec - the tool-execution context; only its optional `agent` is read.
+ * @returns the calling agent's session cwd, or undefined for a non-agent caller.
+ */
+export function sessionCwd(exec) {
+    return exec.agent?.session.header.cwd;
+}
+/**
+ * Resolve a user-supplied path against the session workspace (absolute paths
+ * pass through; relative paths join `base`).
+ * @param input - the path as the model provided it.
+ * @param base - the resolution root (session cwd or an explicit call cwd).
+ * @returns the resolved absolute path.
+ */
+export function resolveToCwd(input, base) {
+    return path.isAbsolute(input) ? input : path.resolve(base, input);
+}
+/**
+ * The effective working directory for one call: the explicit `cwd` arg when
+ * present (absolute, or joined onto the session cwd), else the session cwd.
+ * @param args - parsed call arguments.
+ * @param workspace - the session workspace cwd (required).
+ * @returns the resolved call working directory.
+ */
+export function resolveCallCwd(args, workspace) {
+    if (args.cwd === undefined)
+        return workspace;
+    return path.isAbsolute(args.cwd) ? args.cwd : path.resolve(workspace, args.cwd);
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAGjC;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAmB;IAC5C,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAA;AACvC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,IAAY;IACtD,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;AACnE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAA+B,EAAE,SAAiB;IAC/E,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC5C,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;AACjF,CAAC"}