@harrylabsj/kiwi 0.6.0

package/dist/operator/tui.js

@@ -0,0 +1,395 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Operator TUI (design §11–§12) — plain node:readline over injected streams.
+ * No UI dependency, no TTY requirement: input/output are injected, so tests
+ * drive it with in-memory streams. The TUI only renders controller state and
+ * calls typed OperatorController methods; no state transitions live here.
+ *
+ * Visibility labels follow design §11: 私有 (operator-only), 公开草稿
+ * (public draft, sent only after approval), 已发送 (authoritative), 建议
+ * (manual-mode advice). Decision summaries are concise lines — never raw
+ * chain-of-thought.
+ */
+import readline from "node:readline";
+import { EXIT } from "../exit-codes.js";
+import { createTheme } from "../tui/styles.js";
+const COMMANDS = `/mode <autopilot|supervised|manual> [confirm]  切换运行模式
+/strategy [confirm]          查看有效策略；confirm 确认放宽变更
+/approve                     批准当前候选决策
+/reject [原因]               驳回当前候选并放弃该轮
+/revise <指令>               带新指令重新生成候选
+/pause                       停止领取新消息
+/resume                      恢复领取消息
+/why                         解释当前候选与策略命中
+/history [n]                 查看最近 n 条操作者事件
+/usage                       查看会话用量
+/quit                        安全退出`;
+function modeLabel(mode) {
+    return mode === "autopilot" ? "Autopilot" : mode === "manual" ? "Manual" : "Supervised";
+}
+/** Bare natural-language aliases for the slash commands (design §12). */
+const BARE_APPROVE = /^(approve|accept|批准)$/i;
+const BARE_REJECT = /^(reject|驳回|拒绝)$/i;
+const BARE_REVISE = /^(revise|重算|重来|重新生成)\s+(.+)$/i;
+/**
+ * Map a bare (no-slash) operator line to its slash command, so `approve` /
+ * `reject` / `revise <指令>` are not swallowed as strategy preferences.
+ * Returns undefined when the line is not a known command alias.
+ */
+function mapBareCommand(line) {
+    const trimmed = line.trim();
+    if (BARE_APPROVE.test(trimmed))
+        return "/approve";
+    if (BARE_REJECT.test(trimmed))
+        return "/reject";
+    const revise = BARE_REVISE.exec(trimmed);
+    if (revise !== null && revise[2] !== undefined)
+        return `/revise ${revise[2].trim()}`;
+    return undefined;
+}
+function renderHeader(controller, write, theme) {
+    const state = controller.getState();
+    const profile = controller.profile;
+    const roleLabel = profile.role === "buyer" ? "Buyer" : "Merchant";
+    // segments 拼接与旧文本逐字节一致（off 模式），TTY 下按语义着色
+    write(theme.segments([
+        { text: `Kiwi ${roleLabel}`, color: "primary", bold: true },
+        profile.agent_id,
+        { text: modeLabel(state.mode), color: modeColor(state.mode) },
+        ...(state.paused ? [{ text: "已暂停", color: "warn" }] : []),
+    ]));
+    write(theme.enabled
+        ? `${theme.paint("会话:", "accent")} ${profile.commerce.base_url} · ${theme.paint("输入 /help 查看命令", "muted", { dim: true })}`
+        : `会话: ${profile.commerce.base_url} · 输入 /help 查看命令`);
+}
+function modeColor(mode) {
+    return mode === "autopilot" ? "accent" : mode === "supervised" ? "primary" : "warn";
+}
+function renderCandidate(controller, candidate, write, theme) {
+    // panel 化：TTY 下 box 包裹；off 下 `─`×56 + 内容（legacy 逐字节复刻）
+    const lines = [];
+    const counterpart = controller.lastCounterpartMessage;
+    if (counterpart !== undefined)
+        lines.push(`对方: ${counterpart}`);
+    lines.push("Kiwi 分析:");
+    for (const line of candidate.analysis)
+        lines.push(`  · ${line}`);
+    if (candidate.route === "advice_only") {
+        lines.push(`建议（manual 模式，不自动提交）: ${candidate.decision.public_message}`);
+        lines.push(`候选 ${candidate.candidate_id} 仅建议 · /reject 放弃 · /revise <指令> 重算`);
+    }
+    else {
+        lines.push(`公开草稿: ${candidate.decision.public_message}`);
+        lines.push(`候选 ${candidate.candidate_id} 等待批准：/approve 批准 · /revise <指令> 重算 · /reject 驳回`);
+    }
+    write(theme.panel(lines, { legacySeparator: true }));
+}
+function renderPrepare(controller, result, write, theme) {
+    switch (result.kind) {
+        case "awaiting_approval":
+        case "advice_ready":
+            renderCandidate(controller, result.candidate, write, theme);
+            break;
+        case "auto_submitted":
+            write(`[已发送] autopilot 已自动提交 ${result.candidate_id}（${result.policy_result}` +
+                `${result.message_id !== undefined ? `，正式消息 #${result.message_id}` : ""}）。`);
+            break;
+        case "blocked":
+            write(`[私有] ${result.reason}`);
+            break;
+        case "no_work":
+            write("[私有] 当前没有待处理消息。");
+            break;
+    }
+}
+function renderApproval(result, write) {
+    switch (result.kind) {
+        case "submitted":
+            if (result.settlement === "completed") {
+                write(`[已发送] 决策已提交（${result.policy_result}` +
+                    `${result.message_id !== undefined ? `，正式消息 #${result.message_id}` : ""}）。`);
+            }
+            else {
+                write(`[私有] 提交未通过策略门（${result.policy_result}），本轮已标记失败，不会重发。`);
+            }
+            break;
+        case "replayed":
+            write(`[私有] 候选 ${result.candidate_id} 已提交过，批准命令幂等重放，不产生重复消息。`);
+            break;
+        case "invalid":
+            write(`[私有] ${result.reason}`);
+            break;
+    }
+}
+function renderStrategy(controller, write) {
+    const strategy = controller.getState().strategy;
+    write("[私有] 当前有效策略:");
+    if (strategy.directives.length === 0 && strategy.pending_relax === undefined) {
+        write("  （暂无会话策略；硬约束来自 profile，模型无权突破）");
+    }
+    for (const d of strategy.directives) {
+        write(`  · [${d.kind}/${d.scope}] ${d.summary}`);
+    }
+    if (strategy.pending_relax !== undefined) {
+        write(`  · 待确认（relax）: ${strategy.pending_relax.summary} — /strategy confirm 应用`);
+    }
+}
+function renderWhy(controller, write) {
+    const report = controller.why();
+    write("[私有] 决策说明:");
+    if (report.note !== undefined)
+        write(`  ${report.note}`);
+    if (report.candidate_id !== undefined) {
+        write(`  候选: ${report.candidate_id} · 路由: ${report.route ?? ""}`);
+    }
+    for (const line of report.analysis)
+        write(`  · ${line}`);
+    if (report.reason_codes.length > 0)
+        write(`  理由代码: ${report.reason_codes.join(", ")}`);
+    if (report.active_directives.length > 0) {
+        write("  生效指令:");
+        for (const d of report.active_directives)
+            write(`    · ${d}`);
+    }
+}
+function renderHistory(controller, arg, write) {
+    const n = Number.parseInt(arg, 10);
+    const events = controller.history(Number.isInteger(n) && n > 0 ? n : 10);
+    write(`[私有] 最近 ${events.length} 条事件:`);
+    for (const event of events) {
+        write(`  ${event.occurred_at}  [${event.visibility}]  ${event.type}${eventSummary(event)}`);
+    }
+}
+function eventSummary(event) {
+    switch (event.type) {
+        case "operator.message":
+            return `  ${event.payload.text}`;
+        case "strategy.patch.proposed":
+        case "strategy.patch.applied":
+        case "strategy.patch.rejected":
+            return `  ${event.payload.patch.kind}: ${event.payload.patch.summary}`;
+        case "mode.changed":
+            return `  ${event.payload.from} -> ${event.payload.to}`;
+        case "candidate.generated":
+            return `  ${event.payload.candidate.candidate_id} (${event.payload.candidate.route})`;
+        case "candidate.approved":
+        case "candidate.rejected":
+        case "candidate.revised":
+        case "decision.submitted":
+            return `  ${event.payload.candidate_id}`;
+        case "turn.settled":
+            return `  ${event.payload.candidate_id} ${event.payload.settlement}`;
+        default:
+            return "";
+    }
+}
+function renderUsage(controller, write) {
+    const stats = controller.usage();
+    write("[私有] 会话用量:");
+    write(`  操作者消息: ${stats.operator_messages} · 策略应用/拒绝: ${stats.patches_applied}/${stats.patches_rejected}`);
+    write(`  候选: ${stats.candidates_generated} · 提交: ${stats.decisions_submitted} · ` +
+        `批准/驳回/重算: ${stats.approvals}/${stats.rejections}/${stats.revisions} · 事件: ${stats.events}`);
+    write("  模型 token: 不适用（v0.2.0 确定性后端；Pi 后端接入后展示）");
+}
+async function handleCommand(controller, line, write, theme) {
+    const parts = line.split(/\s+/);
+    const command = parts[0] ?? "";
+    const rest = parts.slice(1);
+    const arg = rest.join(" ").trim();
+    const state = controller.getState();
+    switch (command) {
+        case "/mode": {
+            if (arg === "") {
+                write(`当前模式: ${modeLabel(state.mode)}`);
+                return;
+            }
+            const target = rest[0] ?? "";
+            const result = await controller.setMode(target, {
+                confirmed: rest[1] === "confirm",
+            });
+            if (result.kind === "changed")
+                write(`[私有] 模式已切换为 ${modeLabel(result.mode)}。`);
+            else if (result.kind === "needs_confirmation")
+                write(`[私有] ${result.reason}`);
+            else if (result.kind === "unchanged")
+                write(`[私有] 已是 ${modeLabel(result.mode)}。`);
+            else
+                write(`[私有] ${result.error}`);
+            return;
+        }
+        case "/strategy": {
+            if (arg === "confirm") {
+                const result = await controller.confirmStrategy();
+                write(result.ok ? "[私有] 已确认并应用放宽变更。" : `[私有] ${result.error}`);
+                return;
+            }
+            renderStrategy(controller, write);
+            return;
+        }
+        case "/approve": {
+            renderApproval(await controller.approve(), write);
+            return;
+        }
+        case "/reject": {
+            const result = await controller.reject(undefined, arg === "" ? undefined : arg);
+            write(result.ok ? "[私有] 已驳回当前候选，本轮不会提交。" : `[私有] ${result.error}`);
+            return;
+        }
+        case "/revise": {
+            renderPrepare(controller, await controller.revise(arg), write, theme);
+            return;
+        }
+        case "/pause": {
+            await controller.pause();
+            write("[私有] 已暂停：不会领取新消息（在途候选仍可处理）。");
+            return;
+        }
+        case "/resume": {
+            await controller.resume();
+            write("[私有] 已恢复领取消息。");
+            return;
+        }
+        case "/why": {
+            renderWhy(controller, write);
+            return;
+        }
+        case "/history": {
+            renderHistory(controller, arg, write);
+            return;
+        }
+        case "/usage": {
+            renderUsage(controller, write);
+            return;
+        }
+        case "/quit": {
+            write("[私有] 正在安全退出…");
+            const result = await controller.shutdown();
+            if (result.abandoned_candidate !== undefined) {
+                write(`[私有] 在途候选 ${result.abandoned_candidate} 已放弃（claim abandoned，未提交）。`);
+            }
+            write("[私有] 已退出。");
+            return;
+        }
+        case "/help": {
+            write(COMMANDS);
+            return;
+        }
+        default:
+            write(`[私有] 未知命令 ${command}，输入 /help 查看命令。`);
+    }
+}
+async function handleLine(controller, line, write, theme) {
+    if (line.startsWith("/")) {
+        await handleCommand(controller, line, write, theme);
+        return;
+    }
+    const bare = mapBareCommand(line);
+    if (bare !== undefined) {
+        await handleCommand(controller, bare, write, theme);
+        return;
+    }
+    const result = await controller.sendOperatorMessage(line);
+    if (result.kind === "applied") {
+        write(`[私有] 策略已应用（${result.patch.kind}）：${result.patch.summary}`);
+    }
+    else if (result.kind === "needs_confirmation") {
+        write(`[私有] 该变更放宽约束：${result.patch.summary}`);
+        write("[私有] 输入 /strategy confirm 确认应用，或继续输入其他指令忽略。");
+    }
+    else if (result.patch?.kind === "chat") {
+        write(`[私有] 该消息未作为策略指令：${result.reason}`);
+    }
+    else if (result.patch?.kind === "out_of_scope") {
+        write(`[私有] 超出 Kiwi v0.2 能力范围：${result.reason}`);
+    }
+    else {
+        write(`[私有] 已拒绝：${result.reason}`);
+    }
+}
+/**
+ * Run the TUI loop. Resolves EXIT.OK on /quit or EOF; on EOF without /quit
+ * the controller is still shut down safely (pending candidate abandoned).
+ */
+export async function runTui(options) {
+    const { controller, input, output } = options;
+    // Neural Awakening 主题（参照 hermes）：非 TTY 时所有样式直通原文。
+    const theme = createTheme(output);
+    const write = (text) => {
+        output.write(`${theme.decorate(text)}\n`);
+    };
+    renderHeader(controller, write, theme);
+    // Initial pull: show the current candidate (supervised never submits here).
+    const initial = await controller.prepareNextCandidate();
+    if (initial.kind !== "no_work" && initial.kind !== "blocked") {
+        renderPrepare(controller, initial, write, theme);
+    }
+    const rl = readline.createInterface({
+        input,
+        output,
+        terminal: input.isTTY === true,
+        prompt: theme.enabled ? theme.paint("kiwi> ", "accent") : "kiwi> ",
+    });
+    // EOF (Ctrl-D, or an injected stream that ends) closes the interface while
+    // the last command is still being awaited; prompting a closed readline
+    // throws ERR_USE_AFTER_CLOSE, so track it and skip the re-prompt.
+    let rlClosed = false;
+    rl.once("close", () => {
+        rlClosed = true;
+    });
+    // 状态栏 + prompt 重绘（TTY-only；非 TTY 零额外字节）。
+    const refreshPrompt = () => {
+        if (rlClosed)
+            return;
+        if (theme.enabled) {
+            output.write("\r\u001b[K");
+            const state = controller.getState();
+            const roleLabel = controller.profile.role === "buyer" ? "Buyer" : "Merchant";
+            output.write(`${theme.statusBar([
+                { text: `Kiwi ${roleLabel}`, color: "primary", bold: true },
+                controller.profile.agent_id,
+                { text: modeLabel(state.mode), color: modeColor(state.mode) },
+                ...(state.paused ? [{ text: "已暂停", color: "warn" }] : []),
+            ])}\n`);
+        }
+        rl.prompt();
+    };
+    refreshPrompt();
+    for await (const rawLine of rl) {
+        const line = String(rawLine).trim();
+        if (line !== "") {
+            await handleLine(controller, line, write, theme);
+        }
+        if (controller.getState().shutdown)
+            break;
+        // After each command, surface newly arrived work (never auto-submits in
+        // supervised/manual; prepare is a no-op while one candidate is pending).
+        if (!controller.getState().paused && controller.getState().approval.kind === "idle") {
+            const prepared = await controller.prepareNextCandidate();
+            if (prepared.kind !== "no_work" && prepared.kind !== "blocked") {
+                renderPrepare(controller, prepared, write, theme);
+            }
+        }
+        if (!rlClosed)
+            refreshPrompt();
+    }
+    rl.close();
+    if (!controller.getState().shutdown) {
+        await controller.shutdown();
+    }
+    return EXIT.OK;
+}
+//# sourceMappingURL=tui.js.map

package/dist/operator/tui.js.map

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

package/dist/operator/types.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Operator control plane types (docs/operator-tui-v0.2.md §5–§10).
+ *
+ * Three state domains stay separate: the marketplace conversation (owned by
+ * shopping-cli), the operator session (this private event stream), and the
+ * reasoning session (per-turn, never persisted here). Operator state is
+ * derived by folding an append-only event log; nothing here calls HTTP or
+ * holds secrets — formal writes stay behind CommerceClient.
+ */
+import type { DecisionAction, NegotiationDecision, Role } from "../negotiation/types.js";
+/** Runtime modes (design §9). Default is `supervised`. */
+export type OperatorMode = "autopilot" | "supervised" | "manual";
+export declare const OPERATOR_MODES: readonly OperatorMode[];
+/**
+ * Strategy patch risk classes (design §8).
+ *
+ * `forbidden` attacks a product boundary and is always refused;
+ * `out_of_scope` is a task Kiwi v0.2 does not execute (listing/inventory/
+ * refunds) — also refused, never applied; `chat` is operator chatter that is
+ * not a strategy statement — also refused, never applied. Only tighten /
+ * soft_preference / relax shape the effective strategy.
+ */
+export type PatchKind = "tighten" | "soft_preference" | "relax" | "forbidden" | "out_of_scope" | "chat";
+/** `turn` directives expire after one candidate settles; `session` persist. */
+export type PatchScope = "session" | "turn";
+/**
+ * Structured result of compiling one operator message. The raw text never
+ * enters the negotiation prompt directly; only the classified patch is kept.
+ */
+export interface StrategyPatch {
+    kind: PatchKind;
+    scope: PatchScope;
+    /** One-line operator-facing summary of what was understood. */
+    summary: string;
+    /** Normalized directive text, kept private and applied to future turns. */
+    directive: string;
+    /** relax patches never apply without an explicit second confirmation. */
+    requires_confirmation: boolean;
+    /** Deterministic rule ids that produced this classification (for /why). */
+    matched_rules: string[];
+}
+/** Patch kinds that may end up in the effective strategy (never-applied kinds excluded). */
+export type AppliedPatchKind = Exclude<PatchKind, "forbidden" | "out_of_scope" | "chat">;
+/** An applied strategy directive inside the effective strategy. */
+export interface StrategyDirective {
+    kind: AppliedPatchKind;
+    scope: PatchScope;
+    directive: string;
+    summary: string;
+    applied_at: string;
+}
+/**
+ * The compiled session view: applied directives plus at most one relax patch
+ * awaiting explicit confirmation. HardPolicy (profile buyer_policy /
+ * merchant_policy) is NOT here — it lives in the profile and can never be
+ * widened by a patch.
+ */
+export interface EffectiveStrategy {
+    version: 1;
+    directives: StrategyDirective[];
+    /** relax patch waiting for the operator's explicit confirmation. */
+    pending_relax?: StrategyPatch;
+}
+/** Approval-gate routing for a generated candidate (design §9). */
+export type CandidateRoute = "auto_submit" | "await_approval" | "advice_only";
+export type CandidateStatus = "awaiting_approval" | "advice_only" | "approved" | "submitted" | "settled" | "rejected" | "superseded" | "expired";
+/** Claim binding a candidate replies to; re-validated before any submit. */
+export interface CandidateBinding {
+    conversation_id: string;
+    message_id: number;
+    idempotency_key: string;
+}
+/**
+ * An untrusted decision candidate. In supervised mode it is never submitted
+ * before `/approve`; in manual mode it is advice only. `decision.public_message`
+ * is the 公开草稿 (public draft) shown to the operator.
+ */
+export interface Candidate {
+    candidate_id: string;
+    binding: CandidateBinding;
+    decision: NegotiationDecision;
+    /** Concise decision-summary lines — never raw chain-of-thought. */
+    analysis: string[];
+    route: CandidateRoute;
+    status: CandidateStatus;
+    created_at: string;
+}
+/** Approval sub-state of the operator session (design §10, reduced). */
+export type ApprovalState = {
+    kind: "idle";
+} | {
+    kind: "awaiting_approval";
+    candidate_id: string;
+} | {
+    kind: "advice_ready";
+    candidate_id: string;
+};
+/** Event visibility (design §6). Private events never leave this process. */
+export type EventVisibility = "private" | "public_draft" | "public_sent";
+interface OperatorEventBase {
+    event_id: string;
+    occurred_at: string;
+    agent_id: string;
+    role: Role;
+    visibility: EventVisibility;
+    /** Operator identity source, e.g. "local_tui". */
+    origin: string;
+}
+/** Append-only operator event stream (design §6). */
+export type OperatorEvent = OperatorEventBase & ({
+    type: "operator.message";
+    payload: {
+        text: string;
+    };
+} | {
+    type: "strategy.patch.proposed";
+    payload: {
+        patch: StrategyPatch;
+    };
+} | {
+    type: "strategy.patch.applied";
+    payload: {
+        patch: StrategyPatch;
+    };
+} | {
+    type: "strategy.patch.rejected";
+    payload: {
+        patch: StrategyPatch;
+        reason: string;
+    };
+} | {
+    type: "mode.changed";
+    payload: {
+        from: OperatorMode;
+        to: OperatorMode;
+    };
+} | {
+    type: "negotiation.paused";
+    payload: {
+        reason?: string;
+    };
+} | {
+    type: "negotiation.resumed";
+    payload: {
+        reason?: string;
+    };
+} | {
+    type: "candidate.generated";
+    payload: {
+        candidate: Candidate;
+    };
+} | {
+    type: "candidate.approved";
+    payload: {
+        candidate_id: string;
+    };
+} | {
+    type: "candidate.rejected";
+    payload: {
+        candidate_id: string;
+        reason?: string;
+    };
+} | {
+    type: "candidate.revised";
+    payload: {
+        candidate_id: string;
+        instruction: string;
+    };
+} | {
+    type: "decision.submitted";
+    payload: {
+        candidate_id: string;
+        action: DecisionAction;
+        policy_result: string;
+        message_id?: number;
+    };
+} | {
+    type: "turn.settled";
+    payload: {
+        candidate_id: string;
+        settlement: "completed" | "failed" | "abandoned";
+        reason?: string;
+    };
+});
+export type OperatorEventType = OperatorEvent["type"];
+/** Counters surfaced by `/usage`. Model tokens are backend-dependent. */
+export interface OperatorStats {
+    operator_messages: number;
+    patches_applied: number;
+    patches_rejected: number;
+    candidates_generated: number;
+    decisions_submitted: number;
+    approvals: number;
+    rejections: number;
+    revisions: number;
+}
+/** The reduced operator session, rebuilt by folding the event stream. */
+export interface OperatorState {
+    started: boolean;
+    shutdown: boolean;
+    mode: OperatorMode;
+    paused: boolean;
+    strategy: EffectiveStrategy;
+    approval: ApprovalState;
+    candidates: Map<string, Candidate>;
+    stats: OperatorStats;
+    event_count: number;
+}
+export {};

package/dist/operator/types.js

@@ -0,0 +1,17 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export const OPERATOR_MODES = ["autopilot", "supervised", "manual"];
+//# sourceMappingURL=types.js.map

package/dist/operator/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/operator/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgBH,MAAM,CAAC,MAAM,cAAc,GAA4B,CAAC,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC"}