@duetso/agent 0.1.20

package/dist/src/turn-runner/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/turn-runner/skills.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAsB,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAEjF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AAuDD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,KAAK,EAAE,CAEvE;AAED,wBAAgB,oBAAoB,CAClC,gBAAgB,EAAE,qBAAqB,GAAG,SAAS,EACnD,GAAG,EAAE,MAAM,GACV,sBAAsB,CAMxB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,sBAAsB,CAG3E;AAkBD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,KAAK,EAAE,GAAG,KAAK,EAAE,CASjG;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAG1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,CAU7F"}

package/dist/src/turn-runner/skills.js

@@ -0,0 +1,130 @@
+import { execFileSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve, sep } from "node:path";
+import { loadSkills } from "@earendil-works/pi-coding-agent";
+const SKILL_SHELL_EXPANSION_PATTERN = /!`([\s\S]*?)`/g;
+const DEFAULT_SKILL_DIR_NAMES = [".duet", ".agents", ".claude"];
+function buildSkillDiscoveryOptions(options, cwd) {
+    const effectiveCwd = options?.cwd ?? cwd;
+    const globalSkillRoots = options?.agentDir
+        ? [options.agentDir]
+        : DEFAULT_SKILL_DIR_NAMES.map((dirName) => join(homedir(), dirName));
+    const includeDefaults = options?.includeDefaults ?? true;
+    return {
+        cwd: effectiveCwd,
+        agentDir: globalSkillRoots[0],
+        includeDefaults: false,
+        skillPaths: uniquePaths([
+            ...(includeDefaults ? defaultSkillPaths(globalSkillRoots, effectiveCwd) : []),
+            ...(options?.skillPaths ?? []),
+        ]),
+    };
+}
+function defaultSkillPaths(globalSkillRoots, cwd) {
+    // Project before global so a project-local skill can shadow a same-named
+    // global one. Within each scope, .duet > .agents > .claude (first scanned
+    // wins on name collisions).
+    return [
+        ...DEFAULT_SKILL_DIR_NAMES.map((dirName) => join(cwd, dirName, "skills")),
+        ...globalSkillRoots.map((root) => join(root, "skills")),
+    ];
+}
+function uniquePaths(paths) {
+    return Array.from(new Set(paths));
+}
+function expandSkillShellCommands(content, cwd) {
+    return content.replace(SKILL_SHELL_EXPANSION_PATTERN, (_match, command) => {
+        const output = execFileSync("bash", ["-lc", command], {
+            cwd,
+            encoding: "utf-8",
+            maxBuffer: 1024 * 1024,
+            timeout: 30_000,
+        });
+        return output.trimEnd();
+    });
+}
+function expandSkillMetadata(skill) {
+    return {
+        ...skill,
+        description: expandSkillShellCommands(skill.description, skill.baseDir),
+    };
+}
+export function prepareExplicitSkills(skills) {
+    return skills.map(expandSkillMetadata);
+}
+export function loadDiscoveredSkills(discoveryOptions, cwd) {
+    const { skills, diagnostics } = loadSkills(buildSkillDiscoveryOptions(discoveryOptions, cwd));
+    return {
+        skills: skills.map(expandSkillMetadata),
+        collisions: extractSkillCollisions(diagnostics),
+    };
+}
+/**
+ * Discover installed skills without running shell-expansion in their metadata.
+ * Intended for read-only listing (e.g. `duet skills`) where executing the
+ * skills' shell commands would be a side effect users don't want.
+ */
+export function discoverInstalledSkills(cwd) {
+    const { skills, diagnostics } = loadSkills(buildSkillDiscoveryOptions(undefined, cwd));
+    return { skills, collisions: extractSkillCollisions(diagnostics) };
+}
+function extractSkillCollisions(diagnostics) {
+    const collisions = [];
+    for (const diagnostic of diagnostics) {
+        const collision = diagnostic.collision;
+        if (diagnostic.type !== "collision" || !collision || collision.resourceType !== "skill") {
+            continue;
+        }
+        collisions.push({
+            name: collision.name,
+            winnerPath: collision.winnerPath,
+            loserPath: collision.loserPath,
+        });
+    }
+    return collisions;
+}
+export function mergeSkillsByName(primary, secondary) {
+    const merged = [...primary];
+    const seenNames = new Set(primary.map((skill) => skill.name));
+    for (const skill of secondary) {
+        if (!seenNames.has(skill.name)) {
+            merged.push(skill);
+        }
+    }
+    return merged;
+}
+export function readSkillInstructions(skill) {
+    const content = readFileSync(skill.filePath, "utf-8");
+    return expandSkillShellCommands(content, skill.baseDir);
+}
+/**
+ * Resolve the effective scope of a skill based on which discovery root it
+ * actually lives under.
+ *
+ * pi-coding-agent only labels a single user dir + a single project dir as
+ * "user"/"project" — anything else routes to "temporary". duet-agent scans
+ * three roots (.duet, .agents, .claude) per scope, so we re-label here so
+ * downstream consumers get the truth instead of mostly-"temporary".
+ */
+export function resolveSkillScope(skill, cwd) {
+    const baseDir = resolve(skill.baseDir);
+    const home = homedir();
+    for (const dirName of DEFAULT_SKILL_DIR_NAMES) {
+        if (isUnderPath(baseDir, join(home, dirName, "skills")))
+            return "user";
+    }
+    for (const dirName of DEFAULT_SKILL_DIR_NAMES) {
+        if (isUnderPath(baseDir, join(cwd, dirName, "skills")))
+            return "project";
+    }
+    return "temporary";
+}
+function isUnderPath(target, root) {
+    const normalizedRoot = resolve(root);
+    if (target === normalizedRoot)
+        return true;
+    const prefix = normalizedRoot.endsWith(sep) ? normalizedRoot : `${normalizedRoot}${sep}`;
+    return target.startsWith(prefix);
+}
+//# sourceMappingURL=skills.js.map

package/dist/src/turn-runner/skills.js.map

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

package/dist/src/turn-runner/state-machine-controller.d.ts

@@ -0,0 +1,90 @@
+import type { TurnQuestion, TurnRunnerTerminalStatus } from "../types/protocol.js";
+import type { StateMachineAgentState, StateMachineDefinition, StateMachineSession } from "../types/state-machine.js";
+import { type ShellPartialOutput } from "./shell-state-handle.js";
+import { type StateMachineRunnerDecision } from "./tools.js";
+export type StateMachineExecutionResult = {
+    type: "state_completed";
+    stateName: string;
+    output?: unknown;
+} | {
+    type: "terminal";
+    status: TurnRunnerTerminalStatus;
+    result?: string;
+    error?: string;
+} | {
+    type: "ask";
+    questions: TurnQuestion[];
+} | {
+    type: "sleep";
+    wakeAt: number;
+} | {
+    type: "interrupted";
+};
+export type StateAgentResult = {
+    type: "complete";
+    result?: string;
+} | {
+    type: "ask";
+    questions: TurnQuestion[];
+} | {
+    type: "failed";
+    error: string;
+} | {
+    type: "interrupted";
+};
+export interface StateAgentHandle {
+    /** Starts the state agent from a fresh transcript owned by the host. */
+    prompt(): Promise<StateAgentResult>;
+    /** Aborts the in-process state agent; persisted state-agent messages are discarded. */
+    interrupt(): void;
+    /** Text-only partial output used for interruption history without persisting messages. */
+    partialAssistantText(): string | undefined;
+}
+export type ActiveStateOutput = {
+    state?: string;
+    kind: "agent";
+    output?: {
+        assistantText?: string;
+    };
+} | {
+    state: string;
+    kind: "script" | "poll";
+    output?: ShellPartialOutput;
+};
+export interface StateMachineControllerConfig {
+    /** Default working directory used by script and poll-script states. */
+    cwd: string;
+    /** Builds a fresh transient state-agent handle for one agent state execution. */
+    createStateAgent(input: {
+        state: StateMachineAgentState;
+        prompt: string;
+    }): StateAgentHandle;
+}
+export declare class StateMachineController {
+    private readonly config;
+    private session?;
+    private activeRun?;
+    constructor(config: StateMachineControllerConfig);
+    hydrate(stateMachine: StateMachineSession | undefined): void;
+    getSession(): StateMachineSession | undefined;
+    hasActiveWork(): boolean;
+    getActiveOutput(): ActiveStateOutput | undefined;
+    startSession(input: {
+        prompt: string;
+        definition: StateMachineDefinition;
+        currentState: string;
+    }): void;
+    interrupt(reason?: string): void;
+    runDecision(decision: StateMachineRunnerDecision): Promise<StateMachineExecutionResult>;
+    wake(): Promise<StateMachineExecutionResult | undefined>;
+    private runAgentState;
+    private runScriptState;
+    private runPollState;
+    private runTimerState;
+    private runTerminalState;
+    private recordInterruptedState;
+    private interruptedOutput;
+    private interruptibleStateName;
+    private requireSession;
+}
+//# sourceMappingURL=state-machine-controller.d.ts.map

package/dist/src/turn-runner/state-machine-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine-controller.d.ts","sourceRoot":"","sources":["../../../src/turn-runner/state-machine-controller.ts"],"names":[],"mappings":"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"}

package/dist/src/turn-runner/state-machine-controller.js

@@ -0,0 +1,289 @@
+import { INTERRUPTED_STATE_MACHINE_STATE } from "../types/state-machine.js";
+import { currentScheduledState, elapsedSinceStateStarted, findState, recordRunnerDecision, recordStateAskedUser, recordStateCompleted, recordStateFailed, recordStateInterrupted, recordStateMachineCompleted, recordStateStarted, recordStateSleep, createStateMachineSession, } from "./state-machine-session.js";
+import { createShellStateHandle, parseJsonObject, parseStructuredOutput, renderTemplate, ShellCommandError, } from "./shell-state-handle.js";
+import { applyStateOverride } from "./tools.js";
+export class StateMachineController {
+    config;
+    session;
+    activeRun;
+    constructor(config) {
+        this.config = config;
+    }
+    hydrate(stateMachine) {
+        this.session = stateMachine;
+    }
+    getSession() {
+        return this.session;
+    }
+    hasActiveWork() {
+        return Boolean(this.activeRun);
+    }
+    getActiveOutput() {
+        const run = this.activeRun;
+        if (!run)
+            return undefined;
+        if (run.kind === "agent") {
+            const assistantText = run.agent.partialAssistantText();
+            return assistantText
+                ? { state: run.state, kind: "agent", output: { assistantText } }
+                : { state: run.state, kind: "agent" };
+        }
+        if (run.kind === "script") {
+            const output = run.shell.partialOutput();
+            return output
+                ? { state: run.state, kind: "script", output }
+                : { state: run.state, kind: "script" };
+        }
+        const output = run.shell.partialOutput();
+        return output
+            ? { state: run.state.name, kind: "poll", output }
+            : { state: run.state.name, kind: "poll" };
+    }
+    startSession(input) {
+        this.session = createStateMachineSession(input.prompt, input.definition, input.currentState);
+    }
+    interrupt(reason = "Interrupted") {
+        const run = this.activeRun;
+        if (!run)
+            return;
+        run.interruptedReason = reason;
+        const state = this.interruptibleStateName(run);
+        if (this.session && state) {
+            this.session = recordStateInterrupted(this.session, state, reason, this.interruptedOutput(run));
+        }
+        if (run.kind === "agent") {
+            run.agent.interrupt();
+        }
+        else {
+            run.shell.interrupt();
+        }
+    }
+    async runDecision(decision) {
+        if (this.hasActiveWork()) {
+            // Selecting a state while work is active is an intentional replacement.
+            // The parent can steer state-machine progress by selecting the same state
+            // with new input or by selecting a different state; transient work is
+            // aborted before the new state starts.
+            this.interrupt("Replaced by a newly selected state.");
+        }
+        const stateMachine = this.requireSession();
+        this.session = recordRunnerDecision(stateMachine, decision);
+        if (decision.kind === "fail") {
+            const state = this.session.currentState ?? "unknown";
+            this.session = recordStateFailed(this.session, state, decision.reason);
+            return { type: "terminal", status: "failed", error: decision.reason };
+        }
+        const selectedState = findState(this.session, decision.state);
+        if (!selectedState) {
+            const validStates = this.session.definition.states.map((state) => state.name);
+            const message = `Unknown state: ${decision.state}. Valid states: ${validStates.join(", ")}`;
+            this.session = recordStateFailed(this.session, this.session.currentState ?? decision.state, message);
+            return { type: "terminal", status: "failed", error: message };
+        }
+        const effectiveState = decision.kind === "run_state"
+            ? applyStateOverride(selectedState, decision.override)
+            : selectedState;
+        this.session = recordStateStarted(this.session, effectiveState, decision.kind === "run_state" ? decision.input : undefined);
+        switch (effectiveState.kind) {
+            case "agent":
+                return this.runAgentState(effectiveState);
+            case "script":
+                return this.runScriptState(effectiveState);
+            case "poll":
+                return this.runPollState(effectiveState);
+            case "timer":
+                return this.runTimerState(effectiveState);
+            case "terminal":
+                return this.runTerminalState(effectiveState);
+        }
+    }
+    async wake() {
+        const state = currentScheduledState(this.session);
+        if (!state)
+            return undefined;
+        return state.kind === "poll" ? this.runPollState(state) : this.runTimerState(state, true);
+    }
+    async runAgentState(state) {
+        const prompt = renderTemplate(state.prompt, this.session?.currentInput ?? {});
+        const agent = this.config.createStateAgent({ state, prompt });
+        const run = { kind: "agent", state: state.name, agent };
+        this.activeRun = run;
+        try {
+            const terminal = await agent.prompt();
+            if (terminal.type === "ask") {
+                this.session = recordStateAskedUser(this.requireSession(), state.name, terminal.questions);
+                return { type: "ask", questions: terminal.questions };
+            }
+            if (terminal.type === "failed") {
+                this.session = recordStateFailed(this.requireSession(), state.name, terminal.error);
+                return { type: "terminal", status: "failed", error: terminal.error };
+            }
+            if (terminal.type === "interrupted") {
+                if (this.activeRun === run)
+                    this.recordInterruptedState(run, state.name);
+                return { type: "interrupted" };
+            }
+            const output = { result: terminal.result };
+            this.session = recordStateCompleted(this.requireSession(), state.name, output);
+            return { type: "state_completed", stateName: state.name, output };
+        }
+        finally {
+            if (this.activeRun === run)
+                this.activeRun = undefined;
+        }
+    }
+    async runScriptState(state) {
+        const command = renderTemplate(state.command, this.session?.currentInput ?? {});
+        const shell = createShellStateHandle({
+            command,
+            cwd: state.cwd ?? this.config.cwd,
+            timeoutMs: state.timeoutMs,
+            successCodes: state.successCodes,
+        });
+        const run = { kind: "script", state: state.name, shell };
+        this.activeRun = run;
+        try {
+            const shellOutput = await shell.run();
+            const rawOutput = normalizeStructuredShellOutput(shellOutput);
+            this.session = recordStateCompleted(this.requireSession(), state.name, rawOutput);
+            return { type: "state_completed", stateName: state.name, output: rawOutput };
+        }
+        catch (error) {
+            if (run.interruptedReason) {
+                if (this.activeRun === run)
+                    this.recordInterruptedState(run, state.name, shellPartialOutput(error));
+                return { type: "interrupted" };
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            this.session = recordStateFailed(this.requireSession(), state.name, message);
+            return { type: "terminal", status: "failed", error: message };
+        }
+        finally {
+            if (this.activeRun === run)
+                this.activeRun = undefined;
+        }
+    }
+    async runPollState(state) {
+        const elapsedMs = elapsedSinceStateStarted(this.session, state.name);
+        if (state.timeoutMs !== undefined && elapsedMs >= state.timeoutMs) {
+            const message = `Poll state "${state.name}" timed out after ${elapsedMs}ms.`;
+            this.session = recordStateFailed(this.requireSession(), state.name, message);
+            return { type: "terminal", status: "failed", error: message };
+        }
+        const command = renderTemplate(state.command, this.session?.currentInput ?? {});
+        const shell = createShellStateHandle({
+            command,
+            cwd: state.cwd ?? this.config.cwd,
+            successCodes: state.successCodes,
+        });
+        const run = { kind: "poll", state, shell };
+        this.activeRun = run;
+        try {
+            const shellOutput = await shell.run();
+            const output = parseJsonObject(shellOutput.stdout);
+            if (Object.keys(output).length === 0) {
+                const wakeAt = Date.now() + state.intervalMs;
+                this.session = recordStateSleep(this.requireSession(), state, wakeAt);
+                return { type: "sleep", wakeAt };
+            }
+            const rawOutput = normalizePollShellOutput(shellOutput, output);
+            this.session = recordStateCompleted(this.requireSession(), state.name, rawOutput);
+            return { type: "state_completed", stateName: state.name, output: rawOutput };
+        }
+        catch (error) {
+            if (run.interruptedReason) {
+                if (this.activeRun === run)
+                    this.recordInterruptedState(run, state.name, shellPartialOutput(error));
+                return { type: "interrupted" };
+            }
+            const wakeAt = Date.now() + state.intervalMs;
+            this.session = recordStateSleep(this.requireSession(), state, wakeAt);
+            return { type: "sleep", wakeAt };
+        }
+        finally {
+            if (this.activeRun === run)
+                this.activeRun = undefined;
+        }
+    }
+    runTimerState(state, woke = false) {
+        if (!woke && state.wakeAt > Date.now()) {
+            this.session = recordStateSleep(this.requireSession(), state, state.wakeAt);
+            return { type: "sleep", wakeAt: state.wakeAt };
+        }
+        const output = {
+            elapsedMs: elapsedSinceStateStarted(this.session, state.name),
+            timestamp: Date.now(),
+        };
+        this.session = recordStateCompleted(this.requireSession(), state.name, output);
+        return { type: "state_completed", stateName: state.name, output };
+    }
+    async runTerminalState(state) {
+        const terminal = { state: state.name, status: state.status, reason: state.reason };
+        this.session = recordStateMachineCompleted(this.requireSession(), terminal);
+        return { type: "terminal", status: state.status, result: state.reason };
+    }
+    recordInterruptedState(run, stateName, output) {
+        const session = this.requireSession();
+        const last = session.history.at(-1);
+        if (session.currentState === INTERRUPTED_STATE_MACHINE_STATE &&
+            last?.type === "state_interrupted" &&
+            last.state === stateName) {
+            this.session = {
+                ...session,
+                history: [
+                    ...session.history.slice(0, -1),
+                    {
+                        ...last,
+                        reason: run.interruptedReason ?? last.reason,
+                        output: output ?? last.output,
+                    },
+                ],
+                updatedAt: Date.now(),
+            };
+            return;
+        }
+        this.session = recordStateInterrupted(session, stateName, run.interruptedReason ?? "Interrupted", output);
+    }
+    interruptedOutput(run) {
+        if (run.kind === "agent") {
+            const assistantText = run.agent.partialAssistantText();
+            return assistantText ? { assistantText } : undefined;
+        }
+        return run.shell.partialOutput();
+    }
+    interruptibleStateName(run) {
+        if (run.kind === "agent")
+            return run.state;
+        if (run.kind === "script")
+            return run.state;
+        return run.state.name;
+    }
+    requireSession() {
+        if (!this.session) {
+            throw new Error("No state machine is active.");
+        }
+        return this.session;
+    }
+}
+function normalizeStructuredShellOutput(shellOutput) {
+    return {
+        ...shellOutput,
+        stdout: shellOutput.stdout.trim(),
+        stderr: shellOutput.stderr.trim(),
+        parsed: parseStructuredOutput(shellOutput.stdout),
+    };
+}
+function normalizePollShellOutput(shellOutput, parsed) {
+    return {
+        ...shellOutput,
+        stdout: shellOutput.stdout.trim(),
+        stderr: shellOutput.stderr.trim(),
+        parsed,
+    };
+}
+function shellPartialOutput(error) {
+    if (!(error instanceof ShellCommandError))
+        return undefined;
+    return { stdout: error.output.stdout, stderr: error.output.stderr };
+}
+//# sourceMappingURL=state-machine-controller.js.map

package/dist/src/turn-runner/state-machine-controller.js.map

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

package/dist/src/turn-runner/state-machine-session.d.ts

@@ -0,0 +1,27 @@
+import type { StateMachineDefinition, StateMachinePollState, StateMachineSession, StateMachineState, StateMachineTimerState } from "../types/state-machine.js";
+import type { TurnQuestion } from "../types/protocol.js";
+import type { StateMachineRunnerDecision } from "./tools.js";
+export declare function createStateMachineSession(prompt: string, definition: StateMachineDefinition, currentState: string): StateMachineSession;
+export declare function findState(stateMachine: StateMachineSession, name: string): StateMachineState | undefined;
+export type StateMachineScheduledState = StateMachinePollState | StateMachineTimerState;
+export declare function currentScheduledState(stateMachine: StateMachineSession | undefined): StateMachineScheduledState | undefined;
+export declare function isWaitingOnScheduledState(stateMachine: StateMachineSession | undefined): boolean;
+export declare function recordRunnerDecision(stateMachine: StateMachineSession, decision: StateMachineRunnerDecision): StateMachineSession;
+export declare function recordStateStarted(stateMachine: StateMachineSession, state: StateMachineState, input?: Record<string, unknown>): StateMachineSession;
+export declare function recordStateCompleted(stateMachine: StateMachineSession, state: string, output: unknown): StateMachineSession;
+export declare function recordStateSleep(stateMachine: StateMachineSession, state: StateMachineScheduledState, wakeAt: number): StateMachineSession;
+export declare function elapsedSinceStateStarted(stateMachine: StateMachineSession | undefined, state: string): number;
+export declare function recordStateFailed(stateMachine: StateMachineSession, state: string, error: string): StateMachineSession;
+export declare function recordStateInterrupted(stateMachine: StateMachineSession, state: string, reason?: string, output?: {
+    assistantText?: string;
+} | {
+    stdout: string;
+    stderr: string;
+}): StateMachineSession;
+export declare function recordStateAskedUser(stateMachine: StateMachineSession, state: string, questions: TurnQuestion[]): StateMachineSession;
+export declare function recordStateMachineCompleted(stateMachine: StateMachineSession, terminal: {
+    state: string;
+    status: "completed" | "failed" | "cancelled";
+    reason?: string;
+}): StateMachineSession;
+//# sourceMappingURL=state-machine-session.d.ts.map

package/dist/src/turn-runner/state-machine-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine-session.d.ts","sourceRoot":"","sources":["../../../src/turn-runner/state-machine-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EAErB,mBAAmB,EAEnB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAE7D,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,sBAAsB,EAClC,YAAY,EAAE,MAAM,GACnB,mBAAmB,CAUrB;AAED,wBAAgB,SAAS,CACvB,YAAY,EAAE,mBAAmB,EACjC,IAAI,EAAE,MAAM,GACX,iBAAiB,GAAG,SAAS,CAE/B;AAED,MAAM,MAAM,0BAA0B,GAAG,qBAAqB,GAAG,sBAAsB,CAAC;AAExF,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,mBAAmB,GAAG,SAAS,GAC5C,0BAA0B,GAAG,SAAS,CAOxC;AAED,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,mBAAmB,GAAG,SAAS,GAAG,OAAO,CAEhG;AAED,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,mBAAmB,EACjC,QAAQ,EAAE,0BAA0B,GACnC,mBAAmB,CAMrB;AAED,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,mBAAmB,EACjC,KAAK,EAAE,iBAAiB,EACxB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,mBAAmB,CA8BrB;AAED,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,mBAAmB,EACjC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,OAAO,GACd,mBAAmB,CAYrB;AAED,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,mBAAmB,EACjC,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,MAAM,GACb,mBAAmB,CAWrB;AAED,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,mBAAmB,GAAG,SAAS,EAC7C,KAAK,EAAE,MAAM,GACZ,MAAM,CASR;AAED,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,mBAAmB,EACjC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,mBAAmB,CAkBrB;AAED,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,mBAAmB,EACjC,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvE,mBAAmB,CAuBrB;AAED,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,mBAAmB,EACjC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,YAAY,EAAE,GACxB,mBAAmB,CAUrB;AAED,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,mBAAmB,EACjC,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACzF,mBAAmB,CAWrB"}