@damaall/ccx 0.1.0

package/dist/commands/watch.js

@@ -0,0 +1,201 @@
+/**
+ * watch command：ink Dashboard UI
+ *
+ * --plain 回退到純文字模式（Day 1 的實作）
+ */
+import React from 'react';
+import { render } from 'ink';
+import chalk from 'chalk';
+import { startWatch } from '../core/watcher.js';
+import { listTeamNames } from '../core/team-reader.js';
+import { Dashboard } from '../ui/Dashboard.js';
+import { sendOsNotification } from '../guard/soft-limit.js';
+import { killAllMembers } from '../guard/hard-limit.js';
+import { formatCost, formatTokens, totalTokenCount, formatDuration, formatTimeSince } from '../core/pricing.js';
+export async function runWatch(options) {
+    const teamName = options.team ?? await autoDetectTeam();
+    if (!teamName) {
+        console.error(chalk.red('No active team found.'));
+        console.error('Usage: ccx watch <team-name>');
+        console.error('Run "ccx ls --active" to see active teams.');
+        process.exit(1);
+    }
+    // --kill 啟動確認
+    if (options.kill && options.budget) {
+        console.log(chalk.yellow.bold(`⚠ Hard Limit enabled.`));
+        console.log(chalk.yellow(`  When cost exceeds $${options.budget}, ccx will send C-c to agent tmux panes.`));
+        console.log(chalk.yellow(`  This may cause unfinished work to be lost.`));
+        console.log();
+    }
+    let handle;
+    try {
+        handle = await startWatch({
+            teamName,
+            budget: options.budget,
+            stuckTimeoutMs: options.stuckTimeout ? options.stuckTimeout * 1000 : undefined,
+        });
+    }
+    catch (err) {
+        console.error(chalk.red(err instanceof Error ? err.message : 'Failed to start watch'));
+        process.exit(1);
+    }
+    // Guard: OS notification + hard limit
+    if (options.notify || options.kill) {
+        handle.aggregator.on('event', async (event) => {
+            if (event.type === 'cost_threshold') {
+                if (options.notify) {
+                    await sendOsNotification('ccx budget alert', `${teamName}: ${formatCost(event.current)} / ${formatCost(event.budget)}`);
+                }
+                if (options.kill && event.current >= event.budget) {
+                    const state = handle.aggregator.getState();
+                    const paneIds = getPaneIds(state);
+                    if (paneIds.length > 0) {
+                        await killAllMembers(paneIds);
+                    }
+                }
+            }
+        });
+    }
+    if (options.plain) {
+        // ─── Plain text mode ───
+        let shuttingDown = false;
+        const gracefulShutdown = async () => {
+            if (shuttingDown) {
+                process.exit(1);
+            }
+            shuttingDown = true;
+            try {
+                await handle.stop();
+                console.log(chalk.dim(`\nSaved to: ${handle.snapshotManager.sessionPath}`));
+            }
+            catch {
+                console.error(chalk.dim('\nSnapshot save failed.'));
+            }
+            process.exit(0);
+        };
+        process.on('SIGINT', gracefulShutdown);
+        process.on('SIGTERM', gracefulShutdown);
+        runPlainMode(handle);
+    }
+    else {
+        // ─── ink mode ───
+        // 需要 TTY 支援 raw mode，否則 fallback 到 plain mode
+        if (!process.stdin.isTTY) {
+            console.error(chalk.yellow('stdin is not a TTY — falling back to --plain mode.'));
+            let shuttingDown = false;
+            const gracefulShutdown = async () => {
+                if (shuttingDown) {
+                    process.exit(1);
+                }
+                shuttingDown = true;
+                try {
+                    await handle.stop();
+                    console.log(chalk.dim(`\nSaved to: ${handle.snapshotManager.sessionPath}`));
+                }
+                catch {
+                    console.error(chalk.dim('\nSnapshot save failed.'));
+                }
+                process.exit(0);
+            };
+            process.on('SIGINT', gracefulShutdown);
+            process.on('SIGTERM', gracefulShutdown);
+            runPlainMode(handle);
+            return;
+        }
+        // ink 在 raw mode 下攔截 Ctrl+C（作為 \x03 byte），自動呼叫 exit()
+        // 按 q / Escape 也會在 Dashboard 內呼叫 exit()
+        // waitUntilExit() 在 ink 退出後 resolve → 清理 → process.exit
+        const instance = render(React.createElement(Dashboard, {
+            aggregator: handle.aggregator,
+            budget: options.budget ?? null,
+            hardLimit: options.kill ?? false,
+            sessionPath: handle.snapshotManager.sessionPath,
+        }));
+        // SIGTERM（kill 指令）→ 觸發 ink unmount
+        process.on('SIGTERM', () => instance.unmount());
+        await instance.waitUntilExit();
+        // ink 已釋放 raw mode，Ctrl+C 恢復為 SIGINT
+        // 如果清理過程中使用者按 Ctrl+C → force exit
+        process.on('SIGINT', () => process.exit(1));
+        try {
+            await handle.stop();
+            console.log(chalk.dim(`Saved to: ${handle.snapshotManager.sessionPath}`));
+        }
+        catch {
+            console.error(chalk.dim('Snapshot save failed.'));
+        }
+        process.exit(0);
+    }
+}
+// ─── Plain text mode (Day 1 fallback) ───
+function runPlainMode(handle) {
+    const renderPlain = () => {
+        const state = handle.aggregator.getState();
+        process.stdout.write('\x1B[2J\x1B[H');
+        process.stdout.write(formatPlainDashboard(state));
+    };
+    renderPlain();
+    setInterval(renderPlain, 2000);
+    handle.aggregator.on('event', async (event) => {
+        if (event.type === 'team_deleted') {
+            console.log(chalk.yellow(`\nTeam deleted. Snapshot saved to: ${handle.snapshotManager.sessionPath}`));
+            await handle.stop();
+            process.exit(0);
+        }
+        if (event.type === 'watcher_error') {
+            console.error(chalk.dim(`[watcher] ${event.source}: ${event.message}`));
+        }
+    });
+}
+function formatPlainDashboard(state) {
+    const lines = [];
+    const elapsed = formatDuration(state.elapsedMs);
+    lines.push(`ccx watch: ${state.teamName} (${elapsed})    Cost: ${formatCost(state.totalCost)}`);
+    lines.push('─'.repeat(72));
+    lines.push(`${'AGENTS'.padEnd(30)}${'STATUS'.padEnd(12)}${'ACTIVE'.padEnd(10)}${'TOKENS'.padEnd(10)}COST`);
+    for (let i = 0; i < state.agents.length; i++) {
+        const a = state.agents[i];
+        const prefix = i === state.agents.length - 1 ? '└─' : '├─';
+        const name = `${a.name} (${a.model})`.slice(0, 26);
+        const active = a.lastActivityAt > 0
+            ? formatTimeSince(a.lastActivityAt) : '──';
+        const tokens = formatTokens(totalTokenCount(a.tokenUsage));
+        lines.push(`${prefix} ${name.padEnd(28)}${a.status.padEnd(12)}${active.padEnd(10)}${tokens.padEnd(10)}${formatCost(a.cost)}`);
+    }
+    lines.push(`${''.padEnd(30)}${'TOTAL'.padEnd(12)}${''.padEnd(10)}${formatTokens(totalTokenCount(state.totalTokens)).padEnd(10)}${formatCost(state.totalCost)}`);
+    lines.push('');
+    lines.push('TASKS');
+    for (const t of state.tasks) {
+        const status = t.status === 'in_progress' ? '[working]' : t.status === 'completed' ? '[done]' : `[${t.status}]`;
+        lines.push(`#${t.id.padEnd(5)} ${status.padEnd(12)} ${t.subject.slice(0, 30).padEnd(32)} ${t.owner || '──'}`);
+    }
+    if (state.alerts.length > 0) {
+        lines.push('');
+        lines.push('ALERTS');
+        for (const a of state.alerts.slice(-3)) {
+            lines.push(`⚠ ${a.message}`);
+        }
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+// ─── Auto-detect ───
+async function autoDetectTeam() {
+    const teams = await listTeamNames();
+    if (teams.length === 1)
+        return teams[0];
+    if (teams.length === 0)
+        return null;
+    console.log(chalk.yellow('Multiple active teams found:'));
+    for (const name of teams) {
+        console.log(`  - ${name}`);
+    }
+    console.log(chalk.dim('Specify one: ccx watch <team-name>'));
+    process.exit(1);
+}
+function getPaneIds(state) {
+    // 目前沒有直接拿到 paneId 的方式（config.json 的 tmuxPaneId 通常是空的）
+    // 這是 v1.5 hard limit 的限制
+    return [];
+}
+//# sourceMappingURL=watch.js.map

package/dist/commands/watch.js.map

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

package/dist/core/cursor-reader.d.ts

@@ -0,0 +1,24 @@
+import type { FileCursor, JournalEntry } from './types.js';
+export interface CursorReadResult {
+    readonly newEntries: readonly JournalEntry[];
+    readonly rawLines: readonly string[];
+    readonly cursor: FileCursor;
+}
+/**
+ * 建立新的 FileCursor
+ */
+export declare function createCursor(path: string, agentId: string): FileCursor;
+/**
+ * 從 cursor 的 lastByteOffset 開始讀取新增內容
+ * 回傳 parsed entries（有 usage 的行）和 raw lines（全部行，用於 identity resolve）
+ */
+export declare function readIncremental(cursor: FileCursor): Promise<CursorReadResult>;
+/**
+ * Full scan：從頭讀取整個檔案（startup 用）
+ */
+export declare function readFull(path: string, agentId: string): Promise<CursorReadResult>;
+/**
+ * 更新 cursor 的 identity 狀態
+ */
+export declare function resolveCursorIdentity(cursor: FileCursor, name: string): FileCursor;
+//# sourceMappingURL=cursor-reader.d.ts.map

package/dist/core/cursor-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-reader.d.ts","sourceRoot":"","sources":["../../src/core/cursor-reader.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,UAAU,EAAc,YAAY,EAAe,MAAM,YAAY,CAAA;AAInF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,SAAS,YAAY,EAAE,CAAA;IAC5C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAC5B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAYtE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyDnF;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAGvF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,GACX,UAAU,CAMZ"}

package/dist/core/cursor-reader.js

@@ -0,0 +1,128 @@
+/**
+ * CursorReader：byte-offset based JSONL 差量讀取
+ *
+ * 每個 JSONL 檔案維護獨立狀態：
+ * - UNRESOLVED: 每行的 raw text 都傳給 IdentityResolver 直到找到 teammate_id
+ * - RESOLVED: 只累加 token counts + 維護 ring buffer
+ *
+ * 設計原則：
+ * - 只存 offset + aggregated counts，不存全部 parsed records
+ * - Line-boundary parsing：記錄 lastCompleteLineEndOffset
+ * - Truncation detection：newSize < lastOffset → reset to 0
+ */
+import { stat } from 'node:fs/promises';
+import { createReadStream } from 'node:fs';
+import { createInterface } from 'node:readline';
+import { parseJournalLine } from './data-source-adapter.js';
+import { addUsage, emptyUsage } from './pricing.js';
+const RING_BUFFER_SIZE = 20;
+/**
+ * 建立新的 FileCursor
+ */
+export function createCursor(path, agentId) {
+    return {
+        path,
+        agentId,
+        lastByteOffset: 0,
+        lastInode: 0,
+        state: 'UNRESOLVED',
+        resolvedName: null,
+        accumulated: emptyUsage(),
+        model: null,
+        recentEntries: [],
+    };
+}
+/**
+ * 從 cursor 的 lastByteOffset 開始讀取新增內容
+ * 回傳 parsed entries（有 usage 的行）和 raw lines（全部行，用於 identity resolve）
+ */
+export async function readIncremental(cursor) {
+    const fileStat = await stat(cursor.path).catch(() => null);
+    if (!fileStat) {
+        return { newEntries: [], rawLines: [], cursor };
+    }
+    const currentInode = fileStat.ino;
+    const currentSize = fileStat.size;
+    // Truncation/replacement detection
+    const wasReplaced = cursor.lastInode !== 0 && currentInode !== cursor.lastInode;
+    const wasTruncated = currentSize < cursor.lastByteOffset;
+    let startOffset = cursor.lastByteOffset;
+    let resetAccumulated = cursor.accumulated;
+    if (wasReplaced || wasTruncated) {
+        startOffset = 0;
+        resetAccumulated = emptyUsage();
+    }
+    if (currentSize <= startOffset) {
+        return {
+            newEntries: [],
+            rawLines: [],
+            cursor: { ...cursor, lastInode: currentInode },
+        };
+    }
+    // 讀取新增部分
+    const { entries, rawLines, bytesRead } = await readLines(cursor.path, startOffset, currentSize);
+    // 累加 token usage
+    let accumulated = resetAccumulated;
+    let model = cursor.model;
+    for (const entry of entries) {
+        accumulated = addUsage(accumulated, entry.message.usage);
+        if (!model && entry.message.model) {
+            model = entry.message.model;
+        }
+    }
+    // 更新 ring buffer
+    const existingRecent = wasReplaced || wasTruncated ? [] : [...cursor.recentEntries];
+    const allRecent = [...existingRecent, ...entries];
+    const recentEntries = allRecent.slice(-RING_BUFFER_SIZE);
+    const updatedCursor = {
+        ...cursor,
+        lastByteOffset: startOffset + bytesRead,
+        lastInode: currentInode,
+        accumulated,
+        model,
+        recentEntries,
+    };
+    return { newEntries: entries, rawLines, cursor: updatedCursor };
+}
+/**
+ * Full scan：從頭讀取整個檔案（startup 用）
+ */
+export async function readFull(path, agentId) {
+    const cursor = createCursor(path, agentId);
+    return readIncremental(cursor);
+}
+/**
+ * 更新 cursor 的 identity 狀態
+ */
+export function resolveCursorIdentity(cursor, name) {
+    return {
+        ...cursor,
+        state: 'RESOLVED',
+        resolvedName: name,
+    };
+}
+async function readLines(filePath, startOffset, endOffset) {
+    const entries = [];
+    const rawLines = [];
+    let bytesRead = 0;
+    const stream = createReadStream(filePath, {
+        start: startOffset,
+        end: endOffset - 1,
+        encoding: 'utf-8',
+    });
+    const rl = createInterface({ input: stream, crlfDelay: Infinity });
+    let lastCompleteLineEnd = 0;
+    for await (const line of rl) {
+        const lineBytes = Buffer.byteLength(line, 'utf-8') + 1; // +1 for newline
+        lastCompleteLineEnd += lineBytes;
+        rawLines.push(line);
+        const result = parseJournalLine(line);
+        if (result.ok) {
+            entries.push(result.data);
+        }
+    }
+    stream.destroy();
+    bytesRead = lastCompleteLineEnd;
+    return { entries, rawLines, bytesRead };
+}
+//# sourceMappingURL=cursor-reader.js.map

package/dist/core/cursor-reader.js.map

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

package/dist/core/data-source-adapter.d.ts

@@ -0,0 +1,239 @@
+/**
+ * 資料來源適配層：zod schema validation + 容錯 JSON 解析
+ */
+import { z } from 'zod';
+export declare const TeamMemberSchema: z.ZodObject<{
+    agentId: z.ZodString;
+    name: z.ZodString;
+    agentType: z.ZodString;
+    model: z.ZodDefault<z.ZodString>;
+    joinedAt: z.ZodNumber;
+    tmuxPaneId: z.ZodDefault<z.ZodString>;
+    cwd: z.ZodDefault<z.ZodString>;
+    subscriptions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    agentId: string;
+    name: string;
+    agentType: string;
+    model: string;
+    joinedAt: number;
+    tmuxPaneId: string;
+    cwd: string;
+    subscriptions: string[];
+}, {
+    agentId: string;
+    name: string;
+    agentType: string;
+    joinedAt: number;
+    model?: string | undefined;
+    tmuxPaneId?: string | undefined;
+    cwd?: string | undefined;
+    subscriptions?: string[] | undefined;
+}>;
+export declare const TeamConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    createdAt: z.ZodNumber;
+    leadAgentId: z.ZodString;
+    leadSessionId: z.ZodString;
+    members: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        agentId: z.ZodString;
+        name: z.ZodString;
+        agentType: z.ZodString;
+        model: z.ZodDefault<z.ZodString>;
+        joinedAt: z.ZodNumber;
+        tmuxPaneId: z.ZodDefault<z.ZodString>;
+        cwd: z.ZodDefault<z.ZodString>;
+        subscriptions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        agentId: string;
+        name: string;
+        agentType: string;
+        model: string;
+        joinedAt: number;
+        tmuxPaneId: string;
+        cwd: string;
+        subscriptions: string[];
+    }, {
+        agentId: string;
+        name: string;
+        agentType: string;
+        joinedAt: number;
+        model?: string | undefined;
+        tmuxPaneId?: string | undefined;
+        cwd?: string | undefined;
+        subscriptions?: string[] | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description: string;
+    createdAt: number;
+    leadAgentId: string;
+    leadSessionId: string;
+    members: {
+        agentId: string;
+        name: string;
+        agentType: string;
+        model: string;
+        joinedAt: number;
+        tmuxPaneId: string;
+        cwd: string;
+        subscriptions: string[];
+    }[];
+}, {
+    name: string;
+    createdAt: number;
+    leadAgentId: string;
+    leadSessionId: string;
+    description?: string | undefined;
+    members?: {
+        agentId: string;
+        name: string;
+        agentType: string;
+        joinedAt: number;
+        model?: string | undefined;
+        tmuxPaneId?: string | undefined;
+        cwd?: string | undefined;
+        subscriptions?: string[] | undefined;
+    }[] | undefined;
+}>;
+export declare const TaskDataSchema: z.ZodObject<{
+    id: z.ZodString;
+    subject: z.ZodDefault<z.ZodString>;
+    description: z.ZodDefault<z.ZodString>;
+    activeForm: z.ZodDefault<z.ZodString>;
+    owner: z.ZodDefault<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<["pending", "in_progress", "completed", "deleted"]>>;
+    blocks: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    blockedBy: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    status: "pending" | "in_progress" | "completed" | "deleted";
+    description: string;
+    id: string;
+    subject: string;
+    activeForm: string;
+    owner: string;
+    blocks: string[];
+    blockedBy: string[];
+}, {
+    id: string;
+    status?: "pending" | "in_progress" | "completed" | "deleted" | undefined;
+    description?: string | undefined;
+    subject?: string | undefined;
+    activeForm?: string | undefined;
+    owner?: string | undefined;
+    blocks?: string[] | undefined;
+    blockedBy?: string[] | undefined;
+}>;
+export declare const InboxMessageSchema: z.ZodObject<{
+    from: z.ZodString;
+    text: z.ZodDefault<z.ZodString>;
+    summary: z.ZodDefault<z.ZodString>;
+    timestamp: z.ZodString;
+    color: z.ZodDefault<z.ZodString>;
+    read: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    from: string;
+    text: string;
+    summary: string;
+    timestamp: string;
+    color: string;
+    read: boolean;
+}, {
+    from: string;
+    timestamp: string;
+    text?: string | undefined;
+    summary?: string | undefined;
+    color?: string | undefined;
+    read?: boolean | undefined;
+}>;
+export declare const JournalEntrySchema: z.ZodObject<{
+    sessionId: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodString;
+    message: z.ZodObject<{
+        model: z.ZodDefault<z.ZodString>;
+        usage: z.ZodObject<{
+            input_tokens: z.ZodDefault<z.ZodNumber>;
+            output_tokens: z.ZodDefault<z.ZodNumber>;
+            cache_creation_input_tokens: z.ZodDefault<z.ZodNumber>;
+            cache_read_input_tokens: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            input_tokens: number;
+            output_tokens: number;
+            cache_creation_input_tokens: number;
+            cache_read_input_tokens: number;
+        }, {
+            input_tokens?: number | undefined;
+            output_tokens?: number | undefined;
+            cache_creation_input_tokens?: number | undefined;
+            cache_read_input_tokens?: number | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        model: string;
+        usage: {
+            input_tokens: number;
+            output_tokens: number;
+            cache_creation_input_tokens: number;
+            cache_read_input_tokens: number;
+        };
+    }, {
+        usage: {
+            input_tokens?: number | undefined;
+            output_tokens?: number | undefined;
+            cache_creation_input_tokens?: number | undefined;
+            cache_read_input_tokens?: number | undefined;
+        };
+        model?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    message: {
+        model: string;
+        usage: {
+            input_tokens: number;
+            output_tokens: number;
+            cache_creation_input_tokens: number;
+            cache_read_input_tokens: number;
+        };
+    };
+    timestamp: string;
+    agentId?: string | undefined;
+    sessionId?: string | undefined;
+}, {
+    message: {
+        usage: {
+            input_tokens?: number | undefined;
+            output_tokens?: number | undefined;
+            cache_creation_input_tokens?: number | undefined;
+            cache_read_input_tokens?: number | undefined;
+        };
+        model?: string | undefined;
+    };
+    timestamp: string;
+    agentId?: string | undefined;
+    sessionId?: string | undefined;
+}>;
+export declare function safeParseJson<S extends z.ZodTypeAny>(raw: string, schema: S): {
+    ok: true;
+    data: z.output<S>;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function safeParseJsonArray<S extends z.ZodTypeAny>(raw: string, itemSchema: S): {
+    ok: true;
+    data: Array<z.output<S>>;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * 解析 JSONL 的單一行 — 忽略不完整的行
+ */
+export declare function parseJournalLine(line: string): {
+    ok: true;
+    data: z.output<typeof JournalEntrySchema>;
+} | {
+    ok: false;
+};
+//# sourceMappingURL=data-source-adapter.d.ts.map

package/dist/core/data-source-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-source-adapter.d.ts","sourceRoot":"","sources":["../../src/core/data-source-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS3B,CAAA;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO3B,CAAA;AAEF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;EASzB,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;EAO7B,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa7B,CAAA;AAIF,wBAAgB,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAClD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,GACR;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAWhE;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EACvD,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,CAAC,GACZ;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAEvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GACX;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,CAMzE"}