@kernel.chat/kbot 2.22.3 → 2.23.1

package/dist/guardrails.d.ts

@@ -0,0 +1,61 @@
+export interface Guardrail {
+    id: string;
+    name: string;
+    type: 'input' | 'output' | 'tool';
+    severity: 'block' | 'warn' | 'log';
+    /** Regex pattern to match against content */
+    pattern?: RegExp;
+    /** Name of a built-in validator function */
+    validator?: string;
+    /** Message shown when the guardrail triggers */
+    message: string;
+    enabled: boolean;
+}
+export interface GuardrailViolation {
+    guardrailId: string;
+    severity: 'block' | 'warn' | 'log';
+    message: string;
+    evidence: string;
+}
+export interface GuardrailResult {
+    passed: boolean;
+    violations: GuardrailViolation[];
+}
+/**
+ * Load built-in guardrails and merge with user-defined custom guardrails
+ * from ~/.kbot/guardrails.json.
+ */
+export declare function loadGuardrails(): Guardrail[];
+/**
+ * Check input message before the agent processes it.
+ * Runs all 'input' type guardrails.
+ */
+export declare function checkInput(message: string): GuardrailResult;
+/**
+ * Check agent output before showing to the user.
+ * Runs all 'output' type guardrails.
+ */
+export declare function checkOutput(response: string): GuardrailResult;
+/**
+ * Check a tool call before execution.
+ * Runs all 'tool' type guardrails against the tool name + serialized args.
+ */
+export declare function checkToolCall(toolName: string, args: Record<string, unknown>): GuardrailResult;
+/**
+ * Add a custom guardrail at runtime and persist to ~/.kbot/guardrails.json.
+ */
+export declare function addGuardrail(guardrail: Guardrail): void;
+/**
+ * Remove a custom guardrail by ID. Built-in guardrails cannot be removed
+ * (they can only be disabled).
+ */
+export declare function removeGuardrail(id: string): boolean;
+/**
+ * Set the token budget for the output token-budget guardrail.
+ */
+export declare function setTokenBudget(budget: number): void;
+/**
+ * Get all currently loaded guardrails (built-in + custom).
+ */
+export declare function getGuardrails(): readonly Guardrail[];
+//# sourceMappingURL=guardrails.d.ts.map

package/dist/guardrails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.d.ts","sourceRoot":"","sources":["../src/guardrails.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAA;IACjC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAA;IAClC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAA;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAA;IACf,UAAU,EAAE,kBAAkB,EAAE,CAAA;CACjC;AAgND;;;GAGG;AACH,wBAAgB,cAAc,IAAI,SAAS,EAAE,CA0C5C;AA6CD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CA+B3D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAqB7D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,eAAe,CAoCjB;AAID;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAYvD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAoBnD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,SAAS,SAAS,EAAE,CAGpD"}

package/dist/guardrails.js

@@ -0,0 +1,447 @@
+// K:BOT Guardrails System — Safety checks on inputs, outputs, and tool calls
+//
+// Three layers of protection:
+//   1. Input guardrails  — validate user messages before the agent processes them
+//   2. Output guardrails — scan agent responses before showing to the user
+//   3. Tool guardrails   — check tool calls before execution
+//
+// Built-in guardrails are always active. Users can add custom rules
+// via ~/.kbot/guardrails.json.
+//
+// Complements permissions.ts (confirmation dialogs) and bash.ts
+// (blocked command patterns). Guardrails operate at a higher level —
+// they inspect content semantics, not just command syntax.
+import { readFileSync, existsSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { printWarn, printError } from './ui.js';
+// ── Guardrail registry ──
+const guardrails = [];
+let loaded = false;
+/** Default token budget for output (configurable via custom guardrails) */
+let tokenBudget = 16_000;
+// ── Built-in guardrails ──
+/** API key / secret patterns that should never appear in output */
+const SECRET_PATTERNS = [
+    { pattern: /sk-[a-zA-Z0-9]{20,}/, label: 'OpenAI API key (sk-)' },
+    { pattern: /sk-ant-[a-zA-Z0-9-]{20,}/, label: 'Anthropic API key (sk-ant-)' },
+    { pattern: /AKIA[A-Z0-9]{16}/, label: 'AWS access key (AKIA)' },
+    { pattern: /ghp_[a-zA-Z0-9]{36,}/, label: 'GitHub personal access token (ghp_)' },
+    { pattern: /gho_[a-zA-Z0-9]{36,}/, label: 'GitHub OAuth token (gho_)' },
+    { pattern: /ghu_[a-zA-Z0-9]{36,}/, label: 'GitHub user-to-server token (ghu_)' },
+    { pattern: /ghs_[a-zA-Z0-9]{36,}/, label: 'GitHub server-to-server token (ghs_)' },
+    { pattern: /github_pat_[a-zA-Z0-9_]{22,}/, label: 'GitHub fine-grained PAT' },
+    { pattern: /xoxb-[0-9]+-[a-zA-Z0-9]+/, label: 'Slack bot token (xoxb-)' },
+    { pattern: /xoxp-[0-9]+-[a-zA-Z0-9]+/, label: 'Slack user token (xoxp-)' },
+    { pattern: /-----BEGIN (?:RSA |EC |DSA )?PRIVATE KEY-----/, label: 'Private key (PEM)' },
+    { pattern: /eyJ[a-zA-Z0-9_-]{20,}\.[a-zA-Z0-9_-]{20,}\.[a-zA-Z0-9_-]{20,}/, label: 'JWT token' },
+    { pattern: /SG\.[a-zA-Z0-9_-]{22}\.[a-zA-Z0-9_-]{43}/, label: 'SendGrid API key' },
+    { pattern: /sk_live_[a-zA-Z0-9]{24,}/, label: 'Stripe secret key (sk_live_)' },
+    { pattern: /rk_live_[a-zA-Z0-9]{24,}/, label: 'Stripe restricted key (rk_live_)' },
+];
+/** Destructive command patterns — extends bash.ts BLOCKED_PATTERNS */
+const DESTRUCTIVE_PATTERNS = [
+    { pattern: /rm\s+-rf\s+\//, label: 'rm -rf /' },
+    { pattern: /rm\s+-rf\s+~/, label: 'rm -rf ~' },
+    { pattern: /rm\s+-rf\s+\*/, label: 'rm -rf *' },
+    { pattern: /DROP\s+TABLE/i, label: 'DROP TABLE' },
+    { pattern: /DROP\s+DATABASE/i, label: 'DROP DATABASE' },
+    { pattern: /TRUNCATE\s+TABLE/i, label: 'TRUNCATE TABLE' },
+    { pattern: /DELETE\s+FROM\s+\w+\s*;/i, label: 'DELETE FROM (no WHERE clause)' },
+    { pattern: /git\s+push\s+.*--force/i, label: 'git push --force' },
+    { pattern: /git\s+reset\s+--hard/i, label: 'git reset --hard' },
+    { pattern: /mkfs\./i, label: 'mkfs (format filesystem)' },
+    { pattern: /dd\s+if=.*of=\/dev\//i, label: 'dd to raw device' },
+    { pattern: /chmod\s+-R\s+777/i, label: 'chmod -R 777' },
+    { pattern: /:\(\)\s*\{.*\|.*&\s*\}/, label: 'fork bomb' },
+];
+/** PII patterns for detection */
+const PII_PATTERNS = [
+    { pattern: /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b/, label: 'email address' },
+    { pattern: /\b\d{3}[-.]?\d{3}[-.]?\d{4}\b/, label: 'phone number' },
+    { pattern: /\b\d{3}-\d{2}-\d{4}\b/, label: 'SSN' },
+    { pattern: /\b\d{4}[\s-]?\d{4}[\s-]?\d{4}[\s-]?\d{4}\b/, label: 'credit card number' },
+];
+const VALIDATORS = {
+    /** Detect secrets / API keys in content */
+    'no-secrets': (content) => {
+        const violations = [];
+        for (const { pattern, label } of SECRET_PATTERNS) {
+            const match = pattern.exec(content);
+            if (match) {
+                violations.push({
+                    guardrailId: 'no-secrets-in-output',
+                    severity: 'block',
+                    message: `Detected ${label} in content`,
+                    evidence: match[0].slice(0, 8) + '...' + match[0].slice(-4),
+                });
+            }
+        }
+        return violations;
+    },
+    /** Detect destructive commands */
+    'no-destructive': (content) => {
+        const violations = [];
+        for (const { pattern, label } of DESTRUCTIVE_PATTERNS) {
+            const match = pattern.exec(content);
+            if (match) {
+                violations.push({
+                    guardrailId: 'no-destructive-commands',
+                    severity: 'warn',
+                    message: `Destructive command detected: ${label}`,
+                    evidence: match[0],
+                });
+            }
+        }
+        return violations;
+    },
+    /** Check that file paths in write_file calls refer to existing directories */
+    'no-hallucinated-files': (_content, args) => {
+        const violations = [];
+        if (!args)
+            return violations;
+        const filePath = args.file_path || args.path;
+        if (typeof filePath === 'string' && filePath.length > 0) {
+            // Check that the parent directory exists
+            const parentDir = filePath.replace(/\/[^/]+$/, '');
+            if (parentDir && parentDir !== filePath && !existsSync(parentDir)) {
+                violations.push({
+                    guardrailId: 'no-hallucinated-files',
+                    severity: 'warn',
+                    message: `Parent directory does not exist: ${parentDir}`,
+                    evidence: filePath,
+                });
+            }
+        }
+        return violations;
+    },
+    /** Warn if output exceeds token budget (rough estimate: 1 token ~ 4 chars) */
+    'token-budget': (content) => {
+        const violations = [];
+        const estimatedTokens = Math.ceil(content.length / 4);
+        if (estimatedTokens > tokenBudget) {
+            violations.push({
+                guardrailId: 'token-budget',
+                severity: 'warn',
+                message: `Output exceeds token budget: ~${estimatedTokens} tokens (budget: ${tokenBudget})`,
+                evidence: `${content.length} characters (~${estimatedTokens} tokens)`,
+            });
+        }
+        return violations;
+    },
+    /** Detect PII (emails, phone numbers, SSNs, credit cards) */
+    'pii-filter': (content) => {
+        const violations = [];
+        for (const { pattern, label } of PII_PATTERNS) {
+            const match = pattern.exec(content);
+            if (match) {
+                // Mask the evidence for safety
+                const raw = match[0];
+                const masked = raw.slice(0, 3) + '***' + raw.slice(-2);
+                violations.push({
+                    guardrailId: 'pii-filter',
+                    severity: 'warn',
+                    message: `Possible ${label} detected in output`,
+                    evidence: masked,
+                });
+            }
+        }
+        return violations;
+    },
+};
+/** Built-in guardrail definitions (always active) */
+const BUILTIN_GUARDRAILS = [
+    {
+        id: 'no-secrets-in-output',
+        name: 'No Secrets in Output',
+        type: 'output',
+        severity: 'block',
+        validator: 'no-secrets',
+        message: 'Response contains API keys or secrets. Blocked to prevent accidental exposure.',
+        enabled: true,
+    },
+    {
+        id: 'no-destructive-commands',
+        name: 'No Destructive Commands',
+        type: 'tool',
+        severity: 'warn',
+        validator: 'no-destructive',
+        message: 'Tool call contains a destructive command. Review carefully before proceeding.',
+        enabled: true,
+    },
+    {
+        id: 'no-hallucinated-files',
+        name: 'No Hallucinated File Paths',
+        type: 'tool',
+        severity: 'warn',
+        validator: 'no-hallucinated-files',
+        message: 'File write targets a path whose parent directory does not exist.',
+        enabled: true,
+    },
+    {
+        id: 'token-budget',
+        name: 'Token Budget',
+        type: 'output',
+        severity: 'warn',
+        validator: 'token-budget',
+        message: 'Response exceeds the configured token budget.',
+        enabled: true,
+    },
+    {
+        id: 'pii-filter',
+        name: 'PII Filter',
+        type: 'output',
+        severity: 'warn',
+        validator: 'pii-filter',
+        message: 'Response may contain personally identifiable information.',
+        enabled: true,
+    },
+];
+// ── Loading ──
+/** Path to user-defined custom guardrails */
+function customGuardrailsPath() {
+    return join(homedir(), '.kbot', 'guardrails.json');
+}
+/**
+ * Load built-in guardrails and merge with user-defined custom guardrails
+ * from ~/.kbot/guardrails.json.
+ */
+export function loadGuardrails() {
+    guardrails.length = 0;
+    // Built-in guardrails
+    for (const g of BUILTIN_GUARDRAILS) {
+        guardrails.push({ ...g });
+    }
+    // Custom guardrails from ~/.kbot/guardrails.json
+    const customPath = customGuardrailsPath();
+    if (existsSync(customPath)) {
+        try {
+            const raw = readFileSync(customPath, 'utf-8');
+            const customs = JSON.parse(raw);
+            for (const c of customs) {
+                if (!c.id || !c.name || !c.type || !c.severity || !c.message)
+                    continue;
+                guardrails.push({
+                    id: c.id,
+                    name: c.name,
+                    type: c.type,
+                    severity: c.severity,
+                    pattern: c.pattern ? new RegExp(c.pattern, 'i') : undefined,
+                    message: c.message,
+                    enabled: c.enabled !== false,
+                });
+            }
+        }
+        catch (err) {
+            printWarn(`Failed to load custom guardrails: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    loaded = true;
+    return guardrails;
+}
+/** Ensure guardrails are loaded (lazy initialization) */
+function ensureLoaded() {
+    if (!loaded)
+        loadGuardrails();
+}
+// ── Core check functions ──
+/**
+ * Run a single guardrail against content and optional tool args.
+ */
+function runGuardrail(guardrail, content, args) {
+    if (!guardrail.enabled)
+        return [];
+    const violations = [];
+    // Pattern-based check (custom guardrails)
+    if (guardrail.pattern) {
+        const match = guardrail.pattern.exec(content);
+        if (match) {
+            violations.push({
+                guardrailId: guardrail.id,
+                severity: guardrail.severity,
+                message: guardrail.message,
+                evidence: match[0].length > 80 ? match[0].slice(0, 80) + '...' : match[0],
+            });
+        }
+    }
+    // Validator-based check (built-in guardrails)
+    if (guardrail.validator) {
+        const validatorFn = VALIDATORS[guardrail.validator];
+        if (validatorFn) {
+            violations.push(...validatorFn(content, args));
+        }
+    }
+    return violations;
+}
+/**
+ * Check input message before the agent processes it.
+ * Runs all 'input' type guardrails.
+ */
+export function checkInput(message) {
+    ensureLoaded();
+    const violations = [];
+    for (const g of guardrails) {
+        if (g.type !== 'input')
+            continue;
+        violations.push(...runGuardrail(g, message));
+    }
+    // Also run secrets check on input (prevent prompt injection with keys)
+    const secretViolations = VALIDATORS['no-secrets'](message);
+    for (const v of secretViolations) {
+        v.guardrailId = 'no-secrets-in-input';
+        v.severity = 'warn';
+        v.message = `Input contains ${v.message.replace('Detected ', '').replace(' in content', '')} — be cautious`;
+    }
+    violations.push(...secretViolations);
+    const hasBlocking = violations.some(v => v.severity === 'block');
+    // Log violations
+    for (const v of violations) {
+        if (v.severity === 'block') {
+            printError(`[guardrail] ${v.message}`);
+        }
+        else if (v.severity === 'warn') {
+            printWarn(`[guardrail] ${v.message}`);
+        }
+        // 'log' severity: silent (can be checked by caller)
+    }
+    return { passed: !hasBlocking, violations };
+}
+/**
+ * Check agent output before showing to the user.
+ * Runs all 'output' type guardrails.
+ */
+export function checkOutput(response) {
+    ensureLoaded();
+    const violations = [];
+    for (const g of guardrails) {
+        if (g.type !== 'output')
+            continue;
+        violations.push(...runGuardrail(g, response));
+    }
+    const hasBlocking = violations.some(v => v.severity === 'block');
+    // Log violations
+    for (const v of violations) {
+        if (v.severity === 'block') {
+            printError(`[guardrail] ${v.message}`);
+        }
+        else if (v.severity === 'warn') {
+            printWarn(`[guardrail] ${v.message}`);
+        }
+    }
+    return { passed: !hasBlocking, violations };
+}
+/**
+ * Check a tool call before execution.
+ * Runs all 'tool' type guardrails against the tool name + serialized args.
+ */
+export function checkToolCall(toolName, args) {
+    ensureLoaded();
+    // Build content string from tool name + args for pattern matching
+    const content = `${toolName} ${JSON.stringify(args)}`;
+    const violations = [];
+    for (const g of guardrails) {
+        if (g.type !== 'tool')
+            continue;
+        violations.push(...runGuardrail(g, content, args));
+    }
+    // Special handling for write_file — check hallucinated paths
+    if (toolName === 'write_file' || toolName === 'edit_file') {
+        const pathViolations = VALIDATORS['no-hallucinated-files']('', args);
+        violations.push(...pathViolations);
+    }
+    // Check for destructive commands in bash tool calls
+    if (toolName === 'bash' && typeof args.command === 'string') {
+        const destructiveViolations = VALIDATORS['no-destructive'](args.command);
+        violations.push(...destructiveViolations);
+    }
+    const hasBlocking = violations.some(v => v.severity === 'block');
+    // Log violations
+    for (const v of violations) {
+        if (v.severity === 'block') {
+            printError(`[guardrail] ${v.message}`);
+        }
+        else if (v.severity === 'warn') {
+            printWarn(`[guardrail] ${v.message}`);
+        }
+    }
+    return { passed: !hasBlocking, violations };
+}
+// ── Custom guardrail management ──
+/**
+ * Add a custom guardrail at runtime and persist to ~/.kbot/guardrails.json.
+ */
+export function addGuardrail(guardrail) {
+    ensureLoaded();
+    // Replace if same ID exists
+    const existingIdx = guardrails.findIndex(g => g.id === guardrail.id);
+    if (existingIdx >= 0) {
+        guardrails[existingIdx] = guardrail;
+    }
+    else {
+        guardrails.push(guardrail);
+    }
+    persistCustomGuardrails();
+}
+/**
+ * Remove a custom guardrail by ID. Built-in guardrails cannot be removed
+ * (they can only be disabled).
+ */
+export function removeGuardrail(id) {
+    ensureLoaded();
+    const builtinIds = new Set(BUILTIN_GUARDRAILS.map(g => g.id));
+    if (builtinIds.has(id)) {
+        // Cannot remove built-in — disable instead
+        const g = guardrails.find(gr => gr.id === id);
+        if (g) {
+            g.enabled = false;
+            return true;
+        }
+        return false;
+    }
+    const idx = guardrails.findIndex(g => g.id === id);
+    if (idx < 0)
+        return false;
+    guardrails.splice(idx, 1);
+    persistCustomGuardrails();
+    return true;
+}
+/**
+ * Set the token budget for the output token-budget guardrail.
+ */
+export function setTokenBudget(budget) {
+    tokenBudget = Math.max(100, budget);
+}
+/**
+ * Get all currently loaded guardrails (built-in + custom).
+ */
+export function getGuardrails() {
+    ensureLoaded();
+    return guardrails;
+}
+// ── Persistence ──
+/** Persist only custom guardrails (non-builtin) to ~/.kbot/guardrails.json */
+function persistCustomGuardrails() {
+    const builtinIds = new Set(BUILTIN_GUARDRAILS.map(g => g.id));
+    const customs = guardrails
+        .filter(g => !builtinIds.has(g.id))
+        .map(g => ({
+        id: g.id,
+        name: g.name,
+        type: g.type,
+        severity: g.severity,
+        pattern: g.pattern?.source,
+        message: g.message,
+        enabled: g.enabled,
+    }));
+    const kbotDir = join(homedir(), '.kbot');
+    if (!existsSync(kbotDir)) {
+        mkdirSync(kbotDir, { recursive: true });
+    }
+    try {
+        writeFileSync(customGuardrailsPath(), JSON.stringify(customs, null, 2), 'utf-8');
+    }
+    catch (err) {
+        printWarn(`Failed to save custom guardrails: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+//# sourceMappingURL=guardrails.js.map

package/dist/guardrails.js.map

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

package/dist/handoffs.d.ts

@@ -0,0 +1,54 @@
+export interface Handoff {
+    from: string;
+    to: string;
+    reason: string;
+    context: string;
+    preserveHistory: boolean;
+}
+export interface HandoffResult {
+    agent: string;
+    response: string;
+    handoffChain: string[];
+}
+interface HandoffRule {
+    from: string | '*';
+    to: string;
+    triggers: RegExp[];
+    description: string;
+}
+/**
+ * Analyze if the current agent should hand off to another specialist.
+ * Checks the response and original query against handoff rules.
+ *
+ * Returns a Handoff object if a handoff is recommended, null otherwise.
+ */
+export declare function detectHandoff(agentId: string, response: string, query: string): Handoff | null;
+/**
+ * Build the context string for the receiving agent.
+ * Includes a handoff header, the accumulated context, and the reason.
+ */
+export declare function buildHandoffContext(currentContext: string, handoff: Handoff): string;
+/**
+ * Execute a handoff: call runAgent with the target agent and built context.
+ * Tracks the handoff chain and enforces maximum depth.
+ *
+ * The runAgent function is passed as a parameter to avoid circular imports
+ * (agent.ts imports from many modules, and those modules should not import agent.ts).
+ */
+export declare function executeHandoff(handoff: Handoff, query: string, runAgentFn: (message: string, options: {
+    agent?: string;
+    context?: unknown;
+}) => Promise<{
+    content: string;
+    agent: string;
+}>, chain?: string[]): Promise<HandoffResult>;
+/**
+ * Get all available handoff rules (for diagnostics / UI).
+ */
+export declare function getHandoffRules(): readonly HandoffRule[];
+/**
+ * Check if an agent ID is a valid specialist that can participate in handoffs.
+ */
+export declare function isHandoffTarget(agentId: string): boolean;
+export {};
+//# sourceMappingURL=handoffs.d.ts.map

package/dist/handoffs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoffs.d.ts","sourceRoot":"","sources":["../src/handoffs.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAID,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,GAAG,GAAG,CAAA;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;CACpB;AAwGD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,GAAG,IAAI,CAgDhB;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,OAAO,GACf,MAAM,CAqBR;AAID;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,KAAK,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAC5H,KAAK,GAAE,MAAM,EAAO,GACnB,OAAO,CAAC,aAAa,CAAC,CA8DxB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,SAAS,WAAW,EAAE,CAExD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAExD"}