@agent-relay/harnesses 10.6.7 → 11.0.1

package/dist/ai-sdk/sidecar-main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar-main.d.ts","sourceRoot":"","sources":["../../src/ai-sdk/sidecar-main.ts"],"names":[],"mappings":""}

package/dist/ai-sdk/sidecar-main.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { runAiSdkSidecarMain } from './sidecar.js';
+runAiSdkSidecarMain().catch((error) => {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=sidecar-main.js.map

package/dist/ai-sdk/sidecar-main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar-main.js","sourceRoot":"","sources":["../../src/ai-sdk/sidecar-main.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,mBAAmB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/ai-sdk/sidecar.d.ts

@@ -0,0 +1,20 @@
+import { type RelayAdapterSettings } from './adapter-registry.js';
+export interface AiSdkSidecarConfig {
+    name: string;
+    harness: string;
+    workspace: string;
+    sessionId?: string;
+    settings?: RelayAdapterSettings;
+    instructions?: string;
+    runtimeRoot?: string;
+    permissionMode?: 'allow-reads' | 'allow-edits' | 'allow-all';
+    /** Bounded native harness command idempotency cache; primarily configurable for tests. */
+    maxCommandDedupeEntries?: number;
+}
+export interface AiSdkSidecarIo {
+    input: NodeJS.ReadableStream;
+    write: (line: string) => void | Promise<void>;
+}
+export declare function runAiSdkSidecar(config: AiSdkSidecarConfig, io: AiSdkSidecarIo): Promise<void>;
+export declare function runAiSdkSidecarMain(argv?: readonly string[], env?: NodeJS.ProcessEnv): Promise<void>;
+//# sourceMappingURL=sidecar.d.ts.map

package/dist/ai-sdk/sidecar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../../src/ai-sdk/sidecar.ts"],"names":[],"mappings":"AAeA,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAMxF,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,aAAa,GAAG,aAAa,GAAG,WAAW,CAAC;IAC7D,0FAA0F;IAC1F,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC,cAAc,CAAC;IAC7B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAuED,wBAAsB,eAAe,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmRnG;AAgBD,wBAAsB,mBAAmB,CACvC,IAAI,GAAE,SAAS,MAAM,EAA0B,EAC/C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/ai-sdk/sidecar.js

@@ -0,0 +1,361 @@
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+import { createInterface } from 'node:readline';
+import { NATIVE_HARNESS_PROTOCOL_VERSION, } from '@agent-relay/harness-driver';
+import { aiSdkAdapterRegistry } from './adapter-registry.js';
+import { HarnessHost } from './harness-host.js';
+import { LocalHostSandboxProvider } from './local-host-sandbox.js';
+import { createNativeRelayTools, NATIVE_RELAY_INSTRUCTIONS } from './native-relay-tools.js';
+import { RelayHarnessSession } from './relay-session.js';
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function protocolError(error) {
+    return { code: 'native_harness_command_failed', message: errorMessage(error), retryable: false };
+}
+function commandDigest(command) {
+    const canonical = JSON.stringify([
+        command.kind,
+        command.text ?? null,
+        command.mode ?? null,
+        command.approval_id ?? null,
+        command.instructions ?? null,
+    ]);
+    return createHash('sha256').update(canonical).digest('hex');
+}
+function isCommandFrame(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const frame = value;
+    return (frame.v === 2 &&
+        frame.type === 'native_harness_command' &&
+        typeof frame.request_id === 'string' &&
+        frame.payload?.protocol_version === NATIVE_HARNESS_PROTOCOL_VERSION);
+}
+function isWorkerInputFrame(value) {
+    return Boolean(value && typeof value === 'object' && value.v === 2);
+}
+function eventPayload(event, sequence, timestamp) {
+    const { type, agent: _agent, ...payload } = event;
+    const observability = event.observability ? { ...event.observability, sequence, timestamp } : undefined;
+    return JSON.parse(JSON.stringify({ kind: type, ...payload, ...(observability ? { observability } : {}) }));
+}
+function diagnosticPayload(diagnostic) {
+    return {
+        level: diagnostic.level === 'warn'
+            ? 'warning'
+            : diagnostic.level === 'trace'
+                ? 'debug'
+                : diagnostic.level,
+        message: 'message' in diagnostic && typeof diagnostic.message === 'string'
+            ? diagnostic.message
+            : JSON.stringify(diagnostic),
+        subsystem: diagnostic.subsystem,
+        diagnostic: JSON.parse(JSON.stringify(diagnostic)),
+    };
+}
+export async function runAiSdkSidecar(config, io) {
+    const entry = aiSdkAdapterRegistry.require(config.harness);
+    const harness = await entry.createHarness(config.settings);
+    const provider = new LocalHostSandboxProvider({
+        workspace: config.workspace,
+        runtimeRoot: config.runtimeRoot,
+    });
+    const relayTools = createNativeRelayTools();
+    const instructions = [relayTools.length > 0 ? NATIVE_RELAY_INSTRUCTIONS : undefined, config.instructions]
+        .filter((value) => Boolean(value))
+        .join('\n\n');
+    let diagnosticSequence = 0;
+    let agentEventSequence = 0;
+    let agentEventWrites = Promise.resolve();
+    const write = async (frame) => io.write(`${JSON.stringify(frame)}\n`);
+    const publishEvent = (event) => {
+        agentEventWrites = agentEventWrites.then(async () => {
+            const sequence = ++agentEventSequence;
+            const timestamp = new Date().toISOString();
+            const envelope = {
+                protocol_version: NATIVE_HARNESS_PROTOCOL_VERSION,
+                sequence,
+                timestamp,
+                event: eventPayload(event, sequence, timestamp),
+            };
+            await write({ v: 2, type: 'agent_event', payload: envelope });
+        });
+        return agentEventWrites;
+    };
+    const host = new HarnessHost({
+        harness,
+        sandboxProvider: provider,
+        workspace: config.workspace,
+        sessionId: config.sessionId,
+        instructions: instructions || undefined,
+        tools: relayTools,
+        permissionMode: config.permissionMode,
+        onDiagnostic: async (diagnostic) => {
+            const envelope = {
+                protocol_version: NATIVE_HARNESS_PROTOCOL_VERSION,
+                sequence: ++diagnosticSequence,
+                timestamp: new Date().toISOString(),
+                diagnostic: diagnosticPayload(diagnostic),
+            };
+            await write({ v: 2, type: 'native_harness_diagnostic', payload: envelope });
+        },
+    });
+    const relaySession = new RelayHarnessSession({
+        identity: {
+            id: config.name,
+            name: config.name,
+            handle: config.name.toLowerCase().replaceAll(/[^a-z0-9_-]/g, '-'),
+        },
+        host,
+    });
+    const relayDeliveries = new Map();
+    relaySession.onEvent?.(async (event) => {
+        await publishEvent(event);
+        if (event.type === 'delivery.accepted' && event.deliveryId) {
+            const delivery = relayDeliveries.get(event.deliveryId);
+            if (!delivery)
+                return;
+            relayDeliveries.delete(event.deliveryId);
+            await write({
+                v: 2,
+                type: 'delivery_ack',
+                payload: { delivery_id: event.deliveryId, event_id: delivery.eventId },
+            });
+        }
+    });
+    await host.start();
+    const maxCommandDedupeEntries = Math.max(1, config.maxCommandDedupeEntries ?? 10_000);
+    const acknowledgements = new Map();
+    const lines = createInterface({ input: io.input, crlfDelay: Infinity });
+    for await (const line of lines) {
+        if (!line.trim())
+            continue;
+        let frame;
+        try {
+            frame = JSON.parse(line);
+        }
+        catch (error) {
+            await write({
+                v: 2,
+                type: 'native_harness_diagnostic',
+                payload: {
+                    protocol_version: NATIVE_HARNESS_PROTOCOL_VERSION,
+                    sequence: ++diagnosticSequence,
+                    timestamp: new Date().toISOString(),
+                    diagnostic: {
+                        level: 'error',
+                        message: `Invalid native harness command JSON: ${errorMessage(error)}`,
+                    },
+                },
+            });
+            continue;
+        }
+        if (!isWorkerInputFrame(frame))
+            continue;
+        if (frame.type === 'init_worker') {
+            await write({
+                v: 2,
+                type: 'worker_ready',
+                payload: { name: config.name, runtime: 'headless', sessionId: host.sessionId },
+            });
+            continue;
+        }
+        if (frame.type === 'ping') {
+            await write({ v: 2, type: 'pong', payload: frame.payload });
+            continue;
+        }
+        if (frame.type === 'deliver_relay') {
+            const delivery = frame.payload;
+            try {
+                relayDeliveries.set(delivery.delivery_id, { eventId: delivery.event_id });
+                const receipt = await relaySession.receiveMessage({
+                    id: delivery.event_id,
+                    messageId: delivery.event_id,
+                    kind: delivery.thread_id ? 'thread_reply' : delivery.target.startsWith('#') ? 'channel' : 'dm',
+                    text: delivery.body,
+                    from: { id: delivery.from, name: delivery.from, type: 'agent' },
+                    target: delivery.target.startsWith('#')
+                        ? { kind: 'channel', channelName: delivery.target.slice(1) }
+                        : { kind: 'agent', agentName: delivery.target },
+                    threadId: delivery.thread_id,
+                }, {
+                    id: delivery.delivery_id,
+                    idempotencyKey: delivery.delivery_id,
+                    mode: delivery.injection_mode === 'wait' ? 'on-idle' : 'immediate',
+                    reason: delivery.thread_id ? 'thread-reply' : delivery.target.startsWith('#') ? 'mention' : 'dm',
+                });
+                if (receipt.status === 'failed')
+                    throw new Error(receipt.reason);
+                if (receipt.status === 'accepted') {
+                    const pending = relayDeliveries.get(delivery.delivery_id);
+                    if (pending) {
+                        relayDeliveries.delete(delivery.delivery_id);
+                        await write({
+                            v: 2,
+                            type: 'delivery_ack',
+                            payload: { delivery_id: delivery.delivery_id, event_id: pending.eventId },
+                        });
+                    }
+                }
+            }
+            catch (error) {
+                relayDeliveries.delete(delivery.delivery_id);
+                await write({
+                    v: 2,
+                    type: 'delivery_failed',
+                    payload: {
+                        delivery_id: delivery.delivery_id,
+                        event_id: delivery.event_id,
+                        reason: errorMessage(error),
+                    },
+                });
+            }
+            continue;
+        }
+        if (frame.type === 'shutdown_worker') {
+            await host.destroy();
+            await write({ v: 2, type: 'worker_exited', payload: { code: 0 } });
+            break;
+        }
+        if (!isCommandFrame(frame))
+            continue;
+        const command = frame.payload;
+        const digest = commandDigest(command);
+        const previous = acknowledgements.get(command.idempotency_key);
+        if (previous) {
+            if (previous.digest !== digest) {
+                await write({
+                    v: 2,
+                    type: 'native_harness_command_response',
+                    request_id: frame.request_id,
+                    payload: {
+                        protocol_version: NATIVE_HARNESS_PROTOCOL_VERSION,
+                        request_id: frame.request_id,
+                        idempotency_key: command.idempotency_key,
+                        accepted: false,
+                        active_turn: host.hasActiveTurn,
+                        error: {
+                            code: 'idempotency_conflict',
+                            message: 'Native harness command idempotency key was already used for a different command',
+                            retryable: false,
+                        },
+                    },
+                });
+                continue;
+            }
+            await write({
+                v: 2,
+                type: 'native_harness_command_response',
+                request_id: frame.request_id,
+                payload: {
+                    ...previous.acknowledgement,
+                    request_id: frame.request_id,
+                    duplicate: true,
+                },
+            });
+            continue;
+        }
+        let acknowledgement;
+        try {
+            switch (command.kind) {
+                case 'submit_user_message': {
+                    if (typeof command.text !== 'string')
+                        throw new Error('submit_user_message requires text');
+                    if (command.mode === 'active' && !host.hasActiveTurn) {
+                        throw new Error('No active turn is available for active input');
+                    }
+                    if (command.mode === 'idle' && host.hasActiveTurn) {
+                        throw new Error('An active turn is already running');
+                    }
+                    if (host.hasActiveTurn)
+                        await host.submitUserMessage(command.text);
+                    else
+                        await host.startTurn(command.text, command.idempotency_key);
+                    break;
+                }
+                case 'approve_tool':
+                case 'reject_tool':
+                    if (!command.approval_id)
+                        throw new Error(`${command.kind} requires approval_id`);
+                    await host.submitToolApproval({
+                        approvalId: command.approval_id,
+                        approved: command.kind === 'approve_tool',
+                    });
+                    break;
+                case 'interrupt':
+                    await host.interrupt();
+                    break;
+                case 'compact':
+                    if (command.instructions !== undefined && typeof command.instructions !== 'string') {
+                        throw new Error('compact instructions must be a string');
+                    }
+                    await host.compact(command.instructions);
+                    break;
+                case 'release':
+                    await relaySession.release('native_harness_command');
+                    break;
+                default:
+                    throw new Error(`Unsupported native harness command kind: ${String(command.kind)}`);
+            }
+            acknowledgement = {
+                protocol_version: NATIVE_HARNESS_PROTOCOL_VERSION,
+                request_id: frame.request_id,
+                idempotency_key: command.idempotency_key,
+                accepted: true,
+                active_turn: host.hasActiveTurn,
+            };
+        }
+        catch (error) {
+            acknowledgement = {
+                protocol_version: NATIVE_HARNESS_PROTOCOL_VERSION,
+                request_id: frame.request_id,
+                idempotency_key: command.idempotency_key,
+                accepted: false,
+                active_turn: host.hasActiveTurn,
+                error: protocolError(error),
+            };
+        }
+        acknowledgements.set(command.idempotency_key, { digest, acknowledgement });
+        while (acknowledgements.size > maxCommandDedupeEntries) {
+            const oldest = acknowledgements.keys().next().value;
+            if (oldest === undefined)
+                break;
+            acknowledgements.delete(oldest);
+        }
+        await write({
+            v: 2,
+            type: 'native_harness_command_response',
+            request_id: frame.request_id,
+            payload: acknowledgement,
+        });
+        if (command.kind === 'release' && acknowledgement.accepted)
+            break;
+    }
+    if (host.state !== 'destroyed' && host.state !== 'detached')
+        await host.destroy();
+    await agentEventWrites;
+}
+async function loadConfig(argv, env) {
+    const configIndex = argv.indexOf('--config');
+    const serialized = configIndex >= 0 && argv[configIndex + 1]
+        ? await readFile(argv[configIndex + 1], 'utf8')
+        : env.RELAY_AI_SDK_SIDECAR_CONFIG;
+    if (!serialized)
+        throw new Error('Missing sidecar config (--config or RELAY_AI_SDK_SIDECAR_CONFIG)');
+    const config = JSON.parse(serialized);
+    if (!config.name || !config.harness || !config.workspace) {
+        throw new Error('Sidecar config requires name, harness, and workspace');
+    }
+    return config;
+}
+export async function runAiSdkSidecarMain(argv = process.argv.slice(2), env = process.env) {
+    const config = await loadConfig(argv, env);
+    await runAiSdkSidecar(config, {
+        input: process.stdin,
+        write: (line) => new Promise((resolveWrite, reject) => {
+            process.stdout.write(line, (error) => (error ? reject(error) : resolveWrite()));
+        }),
+    });
+}
+//# sourceMappingURL=sidecar.js.map

package/dist/ai-sdk/sidecar.js.map

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

package/dist/define.d.ts

@@ -1,7 +1,17 @@
 import { type AgentRelay, type HarnessFactory, type RelayHarnessAgent } from '@agent-relay/sdk';
-import type { StaticPtyHarnessDefinition } from '@agent-relay/harness-driver';
+import type { SpawnRuntimeInput, StaticPtyHarnessDefinition } from '@agent-relay/harness-driver';
+import { type AiSdkAdapterRegistryEntry } from './ai-sdk/adapter-registry.js';
+import { AI_SDK_REFERENCE_OBSERVABILITY_PROFILE, getPtyObservabilityProfile } from './observability.js';
+export type HarnessRuntime = 'auto' | 'native' | 'pty';
+export type SelectedHarnessRuntime = Exclude<HarnessRuntime, 'auto'>;
+export interface NativeHarnessSidecarLaunch {
+    command: string;
+    args: string[];
+}
 /** Options accepted when creating an agent from a harness. */
 export interface HarnessCreateInput {
+    /** Runtime selection. `auto` uses only adapters promoted to default. */
+    runtime?: HarnessRuntime;
     /** Explicit agent name/handle. Defaults to `<command>-<n>`. */
     name?: string;
     /** Model passed through to the harness CLI (e.g. `sonnet`, `gpt-5.5`). */
@@ -39,7 +49,32 @@ export interface HarnessAgent extends RelayHarnessAgent {
     cwd?: string;
     env?: Record<string, string>;
     definition: StaticPtyHarnessDefinition;
+    observability: ReturnType<typeof getPtyObservabilityProfile>;
+}
+export interface NativeHarnessAgent extends RelayHarnessAgent {
+    kind: 'native';
+    cli: string;
+    runtime: 'native';
+    adapter: string;
+    model?: string;
+    task?: string;
+    args?: string[];
+    channels?: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    observability: typeof AI_SDK_REFERENCE_OBSERVABILITY_PROFILE;
 }
+export type ManagedHarnessAgent = HarnessAgent | NativeHarnessAgent;
+export interface ManagedHarness extends HarnessFactory<HarnessCreateInput, ManagedHarnessAgent> {
+    readonly runtime: 'pty' | 'native';
+    readonly command: string;
+    readonly adapter: AiSdkAdapterRegistryEntry;
+    create(input?: HarnessCreateInput): Promise<ManagedHarnessAgent>;
+    new: (input?: HarnessCreateInput) => ManagedHarnessAgent;
+}
+export type ManagedPtyHarness = ManagedHarness & StaticPtyHarnessDefinition & {
+    readonly runtime: 'pty';
+};
 /**
  * A harness factory. Remains structurally a {@link StaticPtyHarnessDefinition}
  * (so the runtime can resolve it) while adding the {@link HarnessFactory}
@@ -57,4 +92,17 @@ export interface PtyHarness extends StaticPtyHarnessDefinition, HarnessFactory<H
 }
 /** Wrap a static PTY harness definition in a factory with `create`/`new`. */
 export declare function definePtyHarness(definition: StaticPtyHarnessDefinition): PtyHarness;
+export declare function selectHarnessRuntime(adapter: AiSdkAdapterRegistryEntry, requested?: HarnessRuntime): SelectedHarnessRuntime;
+/** Resolve a public harness name or alias to the runtime the CLI should launch. */
+export declare function resolveHarnessRuntime(harness: string, requested?: HarnessRuntime): SelectedHarnessRuntime;
+/**
+ * Build the broker launch contract for an AI SDK-backed native harness.
+ *
+ * Keeping this as a public, side-effect-free resolver lets the CLI launch the
+ * sidecar through an already-running broker instead of starting a second one.
+ */
+export declare function createNativeHarnessLaunch(adapterName: string, input?: HarnessCreateInput, sidecarLaunch?: NativeHarnessSidecarLaunch): SpawnRuntimeInput;
+/** Define a harness that can select between one official adapter and PTY. */
+export declare function defineManagedHarness(adapterName: string, ptyDefinition: StaticPtyHarnessDefinition): ManagedPtyHarness;
+export declare function defineManagedHarness(adapterName: string): ManagedHarness;
 //# sourceMappingURL=define.d.ts.map

package/dist/define.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAI9E,8DAA8D;AAC9D,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAa,SAAQ,iBAAiB;IACrD,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,iFAAiF;IACjF,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,UAAU,EAAE,0BAA0B,CAAC;CACxC;AAED;;;;GAIG;AACH,MAAM,WAAW,UACf,SAAQ,0BAA0B,EAAE,cAAc,CAAC,kBAAkB,EAAE,YAAY,CAAC;IACpF;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1D,2EAA2E;IAC3E,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,kBAAkB,KAAK,YAAY,CAAC;CACnD;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,0BAA0B,GAAG,UAAU,CAwDnF"}
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"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"}