@shardlink/agent-sdk 0.1.0

package/dist/modules/tasks.d.ts

@@ -0,0 +1,145 @@
+/**
+ * High-level task lifecycle helpers.
+ *
+ * Wraps `/v1/workspaces/:slug/objectives` and `/v1/workspaces/:slug/tasks/*`
+ * with typed inputs, idempotency key generation, and conflict-tolerant claim
+ * semantics so agents can work without writing bespoke JSON by hand.
+ *
+ * @packageDocumentation
+ */
+import { ConflictError } from "../errors.js";
+import type { HttpContext } from "../utils.js";
+import type { ObjectiveRecord, TaskChargeEnvelope, TaskRecord } from "../types.js";
+import type { StreamClient } from "./streams.js";
+/** Artifact produced by a task completion. */
+export interface TaskArtifact {
+    kind: "text" | "link" | "file_pointer";
+    content: string;
+}
+export interface CreateObjectiveInput {
+    workspaceSlug: string;
+    actorSessionToken: string;
+    title: string;
+    spec?: Record<string, unknown>;
+    idempotencyKey?: string;
+}
+export interface CreateTaskInput {
+    workspaceSlug: string;
+    actorSessionToken: string;
+    objectiveId: string;
+    spec?: Record<string, unknown>;
+    priority?: number;
+    idempotencyKey?: string;
+}
+export interface ClaimInput {
+    workspaceSlug: string;
+    actorSessionToken: string;
+    taskId: string;
+    idempotencyKey?: string;
+}
+/** Result of a claim attempt. `winner` is true if the current agent owns the task. */
+export interface ClaimResult {
+    winner: boolean;
+    task?: TaskRecord;
+    conflict?: ConflictError;
+    chargeUnits?: number;
+    remainingSpendUnits?: number;
+    pricingVersion?: string;
+}
+export interface CompleteInput {
+    workspaceSlug: string;
+    actorSessionToken: string;
+    taskId: string;
+    artifact: TaskArtifact;
+    idempotencyKey?: string;
+}
+export interface RaceClaimInput {
+    workspaceSlug: string;
+    actorSessionToken: string;
+    taskId: string;
+    agentAIdentity: string;
+    agentBIdentity: string;
+    idempotencyKey?: string;
+}
+/** Result envelope returned by the governor race-claim arbitration endpoint. */
+export interface RaceClaimResultEnvelope {
+    /** The task post-arbitration. */
+    task?: TaskRecord;
+    /** Identity that won the claim. */
+    winnerIdentity?: string;
+    /** Identity that lost. */
+    loserIdentity?: string;
+    /** Arbitration reason (e.g. `"higher_reputation"`, `"earlier_heartbeat"`). */
+    reason?: string;
+    [key: string]: unknown;
+}
+export type Unsubscribe = () => void;
+/** Workspace-scoped task client. */
+export declare class TasksClient {
+    private readonly http;
+    constructor(http: HttpContext);
+    /**
+     * Create an objective. Governor role required.
+     *
+     * @example
+     * ```ts
+     * const { objective } = await tasks.createObjective({
+     *   workspaceSlug: "ws_1",
+     *   actorSessionToken,
+     *   title: "Triage overnight alerts"
+     * });
+     * ```
+     */
+    createObjective(input: CreateObjectiveInput): Promise<{
+        objective: ObjectiveRecord;
+    }>;
+    /**
+     * Create a standalone task under an existing objective.
+     *
+     * Agents can create tasks for themselves — the control-plane enforces
+     * lease charging for agent-authored tasks automatically.
+     */
+    createTask(input: CreateTaskInput): Promise<TaskChargeEnvelope>;
+    /**
+     * Claim a task. Returns a {@link ClaimResult} instead of throwing on 409 —
+     * `winner: false` means another agent beat you to it.
+     *
+     * @example
+     * ```ts
+     * const claim = await tasks.claim({ workspaceSlug, actorSessionToken, taskId });
+     * if (!claim.winner) {
+     *   console.log("Lost race:", claim.conflict?.message);
+     *   return;
+     * }
+     * ```
+     */
+    claim(input: ClaimInput): Promise<ClaimResult>;
+    /**
+     * Governor-only: arbitrate between two agents racing for the same task.
+     * Returns the server's decision without throwing.
+     */
+    raceClaim(input: RaceClaimInput): Promise<RaceClaimResultEnvelope>;
+    /**
+     * Mark a claimed task complete, attaching the delivered artifact.
+     *
+     * @example
+     * ```ts
+     * await tasks.complete({
+     *   workspaceSlug, actorSessionToken, taskId,
+     *   artifact: { kind: "text", content: "All clear — no alerts triaged." }
+     * });
+     * ```
+     */
+    complete(input: CompleteInput): Promise<TaskChargeEnvelope>;
+    /**
+     * Watch a task for state changes. Routes through a {@link StreamClient}
+     * so consumers don't need to manage their own SSE connection.
+     *
+     * @returns An unsubscribe function that detaches the handler.
+     */
+    watch(stream: StreamClient, taskId: string, handler: (event: {
+        type: string;
+        payload: unknown;
+    }) => void): Unsubscribe;
+}
+//# sourceMappingURL=tasks.d.ts.map

package/dist/modules/tasks.d.ts.map

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

package/dist/modules/tasks.js

@@ -0,0 +1,165 @@
+/**
+ * High-level task lifecycle helpers.
+ *
+ * Wraps `/v1/workspaces/:slug/objectives` and `/v1/workspaces/:slug/tasks/*`
+ * with typed inputs, idempotency key generation, and conflict-tolerant claim
+ * semantics so agents can work without writing bespoke JSON by hand.
+ *
+ * @packageDocumentation
+ */
+import { ConflictError } from "../errors.js";
+import { idempotencyKey } from "../retry.js";
+function idemHeader(key) {
+    return { "idempotency-key": key };
+}
+/** Workspace-scoped task client. */
+export class TasksClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Create an objective. Governor role required.
+     *
+     * @example
+     * ```ts
+     * const { objective } = await tasks.createObjective({
+     *   workspaceSlug: "ws_1",
+     *   actorSessionToken,
+     *   title: "Triage overnight alerts"
+     * });
+     * ```
+     */
+    async createObjective(input) {
+        const key = input.idempotencyKey ?? idempotencyKey(`objective:${input.workspaceSlug}`);
+        return this.http.request({
+            path: `/v1/workspaces/${encodeURIComponent(input.workspaceSlug)}/objectives`,
+            method: "POST",
+            operation: "objective-create",
+            headers: this.http.bearerHeaders(input.actorSessionToken, idemHeader(key)),
+            body: {
+                title: input.title,
+                ...(input.spec ? { spec: input.spec } : {})
+            }
+        });
+    }
+    /**
+     * Create a standalone task under an existing objective.
+     *
+     * Agents can create tasks for themselves — the control-plane enforces
+     * lease charging for agent-authored tasks automatically.
+     */
+    async createTask(input) {
+        const key = input.idempotencyKey ?? idempotencyKey(`task:${input.objectiveId}`);
+        return this.http.request({
+            path: `/v1/workspaces/${encodeURIComponent(input.workspaceSlug)}/tasks`,
+            method: "POST",
+            operation: "task-create",
+            headers: this.http.bearerHeaders(input.actorSessionToken, idemHeader(key)),
+            body: {
+                objectiveId: input.objectiveId,
+                ...(input.priority !== undefined ? { priority: input.priority } : {}),
+                ...(input.spec ? { spec: input.spec } : {})
+            }
+        });
+    }
+    /**
+     * Claim a task. Returns a {@link ClaimResult} instead of throwing on 409 —
+     * `winner: false` means another agent beat you to it.
+     *
+     * @example
+     * ```ts
+     * const claim = await tasks.claim({ workspaceSlug, actorSessionToken, taskId });
+     * if (!claim.winner) {
+     *   console.log("Lost race:", claim.conflict?.message);
+     *   return;
+     * }
+     * ```
+     */
+    async claim(input) {
+        const key = input.idempotencyKey ?? idempotencyKey(`claim:${input.taskId}`);
+        try {
+            const payload = await this.http.request({
+                path: `/v1/workspaces/${encodeURIComponent(input.workspaceSlug)}/tasks/${encodeURIComponent(input.taskId)}/claim`,
+                method: "POST",
+                operation: "task-claim",
+                headers: this.http.bearerHeaders(input.actorSessionToken, idemHeader(key)),
+                body: {}
+            });
+            return {
+                winner: true,
+                task: payload.task,
+                ...(payload.chargeUnits !== undefined ? { chargeUnits: payload.chargeUnits } : {}),
+                ...(payload.remainingSpendUnits !== undefined
+                    ? { remainingSpendUnits: payload.remainingSpendUnits }
+                    : {}),
+                ...(payload.pricingVersion !== undefined ? { pricingVersion: payload.pricingVersion } : {})
+            };
+        }
+        catch (error) {
+            if (error instanceof ConflictError) {
+                return { winner: false, conflict: error };
+            }
+            throw error;
+        }
+    }
+    /**
+     * Governor-only: arbitrate between two agents racing for the same task.
+     * Returns the server's decision without throwing.
+     */
+    async raceClaim(input) {
+        const key = input.idempotencyKey ?? idempotencyKey(`race-claim:${input.taskId}`);
+        return this.http.request({
+            path: `/v1/workspaces/${encodeURIComponent(input.workspaceSlug)}/tasks/${encodeURIComponent(input.taskId)}/race-claim`,
+            method: "POST",
+            operation: "task-race-claim",
+            headers: this.http.bearerHeaders(input.actorSessionToken, idemHeader(key)),
+            body: {
+                agentAIdentity: input.agentAIdentity,
+                agentBIdentity: input.agentBIdentity
+            }
+        });
+    }
+    /**
+     * Mark a claimed task complete, attaching the delivered artifact.
+     *
+     * @example
+     * ```ts
+     * await tasks.complete({
+     *   workspaceSlug, actorSessionToken, taskId,
+     *   artifact: { kind: "text", content: "All clear — no alerts triaged." }
+     * });
+     * ```
+     */
+    async complete(input) {
+        const key = input.idempotencyKey ?? idempotencyKey(`complete:${input.taskId}`);
+        return this.http.request({
+            path: `/v1/workspaces/${encodeURIComponent(input.workspaceSlug)}/tasks/${encodeURIComponent(input.taskId)}/complete`,
+            method: "POST",
+            operation: "task-complete",
+            headers: this.http.bearerHeaders(input.actorSessionToken, idemHeader(key)),
+            body: {
+                artifact: {
+                    kind: input.artifact.kind,
+                    content: input.artifact.content
+                }
+            }
+        });
+    }
+    /**
+     * Watch a task for state changes. Routes through a {@link StreamClient}
+     * so consumers don't need to manage their own SSE connection.
+     *
+     * @returns An unsubscribe function that detaches the handler.
+     */
+    watch(stream, taskId, handler) {
+        const unsubscribe = stream.onAny((event) => {
+            const payload = event.payload;
+            if (payload && (payload.taskId === taskId || payload.id === taskId)) {
+                handler({ type: event.type, payload: event.payload });
+            }
+        });
+        return unsubscribe;
+    }
+}
+//# sourceMappingURL=tasks.js.map

package/dist/modules/tasks.js.map

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

package/dist/modules/telemetry.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Structured telemetry.
+ *
+ * Every SDK operation can emit a {@link TelemetryEvent} describing what
+ * happened, how long it took, and whether it succeeded. The default sink
+ * prints JSON lines to stdout; callers can swap in an OpenTelemetry
+ * bridge, Datadog forwarder, or any custom function.
+ *
+ * Telemetry is **opt-in**. Pass `telemetry: { sink }` to
+ * {@link AgentSdkClient} (or any module that accepts it) to enable.
+ *
+ * Invariants:
+ * - A failing sink never crashes the caller — exceptions are swallowed.
+ * - Event emission is synchronous from the caller's perspective (no await).
+ * - Event shape is stable — future fields are additive.
+ *
+ * @packageDocumentation
+ */
+/** Outcome of a telemetry span. */
+export type TelemetryOutcome = "success" | "error" | "cancelled";
+/** Structured event shape emitted for every instrumented operation. */
+export interface TelemetryEvent {
+    /** Epoch-ms when the event was emitted. */
+    timestamp: number;
+    /** Stable operation key — usually the SDK method or HTTP path family. */
+    operation: string;
+    /** Wall-clock duration of the operation in milliseconds. */
+    duration_ms: number;
+    /** Outcome classification. */
+    outcome: TelemetryOutcome;
+    /** True when `outcome === "success"`. Retained for ergonomics. */
+    success: boolean;
+    /** `ShardLinkError.code` when outcome is error. */
+    error_code?: string;
+    /** HTTP status (0 when not HTTP-originated or unknown). */
+    http_status?: number;
+    /** Whether this error would trigger SDK auto-retry. */
+    retryable?: boolean;
+    /** Correlation id when the server returned one. */
+    correlation_id?: string;
+    /** Workspace slug (set for workspace-scoped ops). */
+    workspace?: string;
+    /** Task id (set for task lifecycle ops). */
+    task_id?: string;
+    /** Estimated/actual cost in USD cents (set by billing-related ops). */
+    cost_cents?: number;
+    /** Tracing span id for correlation across systems. */
+    span_id?: string;
+    /** Parent span id when this span nests inside another. */
+    parent_span_id?: string;
+    /** Free-form attributes. Flat — no nested objects. Values must be primitives. */
+    attrs?: Record<string, string | number | boolean>;
+}
+/** Sink signature — accepts an event, returns nothing (or a promise we don't await). */
+export type TelemetrySink = (event: TelemetryEvent) => void;
+/** Options accepted by the telemetry client. */
+export interface TelemetryClientOptions {
+    /** Destination — defaults to stdout JSON lines. Set `enabled: false` for a no-op. */
+    sink?: TelemetrySink;
+    /** Hard kill switch (honored even when a sink is provided). */
+    enabled?: boolean;
+    /** Static attributes merged into every event. */
+    baseAttrs?: Record<string, string | number | boolean>;
+}
+/** Sink that forwards events to an OpenTelemetry tracer. */
+export interface OpenTelemetryBridge {
+    /** Given an event, emit it as a span through the tracer. */
+    emit(event: TelemetryEvent): void;
+}
+/** Span handle returned by {@link TelemetryClient.start}. */
+export interface TelemetrySpan {
+    readonly operation: string;
+    readonly spanId: string;
+    /** Attach ad-hoc attributes before finishing. */
+    set(attrs: Partial<Omit<TelemetryEvent, "timestamp" | "duration_ms" | "operation">>): void;
+    /** Mark the span successful and emit. */
+    end(outcomeAttrs?: Partial<TelemetryEvent>): void;
+    /** Mark the span errored with the given error and emit. */
+    fail(error: unknown, outcomeAttrs?: Partial<TelemetryEvent>): void;
+    /** Mark the span cancelled (e.g. abort). */
+    cancel(outcomeAttrs?: Partial<TelemetryEvent>): void;
+}
+/** JSON-line stdout sink — safe default. */
+export declare const defaultSink: TelemetrySink;
+/** A sink that drops every event — used when telemetry is disabled. */
+export declare const noopSink: TelemetrySink;
+/**
+ * Lightweight telemetry emitter. Instances are safe to share across the SDK.
+ *
+ * @example
+ * ```ts
+ * const telemetry = new TelemetryClient({ sink: defaultSink });
+ * const span = telemetry.start("task-claim", { workspace: "ws_1" });
+ * try {
+ *   const result = await tasks.claim({ ... });
+ *   span.end({ task_id: result.task?.id });
+ * } catch (err) {
+ *   span.fail(err);
+ *   throw err;
+ * }
+ * ```
+ */
+export declare class TelemetryClient {
+    private readonly sink;
+    private readonly baseAttrs;
+    private readonly enabled;
+    constructor(options?: TelemetryClientOptions);
+    /** Emit a pre-built event. Use {@link start} when you need duration tracking. */
+    emit(event: TelemetryEvent): void;
+    /** Begin a span; call `.end()`, `.fail()`, or `.cancel()` when the operation finishes. */
+    start(operation: string, seed?: Partial<Omit<TelemetryEvent, "timestamp" | "duration_ms" | "operation">>): TelemetrySpan;
+    /** Wrap an async operation with a telemetry span. */
+    instrument<T>(operation: string, fn: (span: TelemetrySpan) => Promise<T>, seed?: Partial<Omit<TelemetryEvent, "timestamp" | "duration_ms" | "operation">>): Promise<T>;
+}
+/**
+ * Build a sink that forwards every event to an OpenTelemetry-compatible
+ * tracer (or any object with an `emit(event)` method). Use this to hook
+ * the SDK into your existing observability stack without building custom
+ * plumbing.
+ *
+ * @example
+ * ```ts
+ * const bridge = {
+ *   emit(event) {
+ *     tracer.startSpan(event.operation, { attributes: { ...event.attrs, duration_ms: event.duration_ms } }).end();
+ *   }
+ * };
+ * const telemetry = new TelemetryClient({ sink: openTelemetrySink(bridge) });
+ * ```
+ */
+export declare function openTelemetrySink(bridge: OpenTelemetryBridge): TelemetrySink;
+/**
+ * Compose multiple sinks into one (fan-out). Every sink receives every
+ * event; failures in one don't block the others.
+ */
+export declare function multiSink(...sinks: TelemetrySink[]): TelemetrySink;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/modules/telemetry.d.ts.map

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

package/dist/modules/telemetry.js

@@ -0,0 +1,203 @@
+/**
+ * Structured telemetry.
+ *
+ * Every SDK operation can emit a {@link TelemetryEvent} describing what
+ * happened, how long it took, and whether it succeeded. The default sink
+ * prints JSON lines to stdout; callers can swap in an OpenTelemetry
+ * bridge, Datadog forwarder, or any custom function.
+ *
+ * Telemetry is **opt-in**. Pass `telemetry: { sink }` to
+ * {@link AgentSdkClient} (or any module that accepts it) to enable.
+ *
+ * Invariants:
+ * - A failing sink never crashes the caller — exceptions are swallowed.
+ * - Event emission is synchronous from the caller's perspective (no await).
+ * - Event shape is stable — future fields are additive.
+ *
+ * @packageDocumentation
+ */
+/** JSON-line stdout sink — safe default. */
+export const defaultSink = (event) => {
+    try {
+        console.log(JSON.stringify(event));
+    }
+    catch {
+        // never let logging break the caller
+    }
+};
+/** A sink that drops every event — used when telemetry is disabled. */
+export const noopSink = () => {
+    // deliberate no-op
+};
+function generateSpanId() {
+    const rand = typeof globalThis.crypto?.randomUUID === "function"
+        ? globalThis.crypto.randomUUID()
+        : Math.random().toString(16).slice(2);
+    return rand.replace(/-/g, "").slice(0, 16);
+}
+function isShardLinkError(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "code" in value &&
+        "status" in value &&
+        "retryable" in value);
+}
+/**
+ * Lightweight telemetry emitter. Instances are safe to share across the SDK.
+ *
+ * @example
+ * ```ts
+ * const telemetry = new TelemetryClient({ sink: defaultSink });
+ * const span = telemetry.start("task-claim", { workspace: "ws_1" });
+ * try {
+ *   const result = await tasks.claim({ ... });
+ *   span.end({ task_id: result.task?.id });
+ * } catch (err) {
+ *   span.fail(err);
+ *   throw err;
+ * }
+ * ```
+ */
+export class TelemetryClient {
+    sink;
+    baseAttrs;
+    enabled;
+    constructor(options = {}) {
+        this.enabled = options.enabled !== false;
+        this.sink = this.enabled ? (options.sink ?? defaultSink) : noopSink;
+        this.baseAttrs = options.baseAttrs ?? {};
+    }
+    /** Emit a pre-built event. Use {@link start} when you need duration tracking. */
+    emit(event) {
+        if (!this.enabled)
+            return;
+        const merged = {
+            ...event,
+            attrs: { ...this.baseAttrs, ...(event.attrs ?? {}) }
+        };
+        try {
+            this.sink(merged);
+        }
+        catch {
+            // swallow sink failures
+        }
+    }
+    /** Begin a span; call `.end()`, `.fail()`, or `.cancel()` when the operation finishes. */
+    start(operation, seed = {}) {
+        const startedAt = Date.now();
+        const spanId = seed.span_id ?? generateSpanId();
+        let additions = { ...seed, span_id: spanId };
+        let finished = false;
+        const finalize = (outcome, extra = {}) => {
+            if (finished)
+                return;
+            finished = true;
+            const merged = {
+                timestamp: Date.now(),
+                operation,
+                duration_ms: Date.now() - startedAt,
+                outcome,
+                success: outcome === "success",
+                ...additions,
+                ...extra,
+                attrs: {
+                    ...this.baseAttrs,
+                    ...(additions.attrs ?? {}),
+                    ...(extra.attrs ?? {})
+                }
+            };
+            this.emit(merged);
+        };
+        return {
+            operation,
+            spanId,
+            set(attrs) {
+                additions = {
+                    ...additions,
+                    ...attrs,
+                    attrs: { ...(additions.attrs ?? {}), ...(attrs.attrs ?? {}) }
+                };
+            },
+            end(outcomeAttrs) {
+                finalize("success", outcomeAttrs ?? {});
+            },
+            fail(error, outcomeAttrs) {
+                const errAttrs = {};
+                if (isShardLinkError(error)) {
+                    errAttrs.error_code = error.code;
+                    errAttrs.http_status = error.status;
+                    errAttrs.retryable = error.retryable;
+                    if (error.correlationId)
+                        errAttrs.correlation_id = error.correlationId;
+                }
+                else if (error instanceof Error) {
+                    errAttrs.error_code = "unknown_error";
+                    errAttrs.attrs = { error_message: error.message };
+                }
+                else {
+                    errAttrs.error_code = "unknown_error";
+                }
+                finalize("error", { ...errAttrs, ...(outcomeAttrs ?? {}) });
+            },
+            cancel(outcomeAttrs) {
+                finalize("cancelled", outcomeAttrs ?? {});
+            }
+        };
+    }
+    /** Wrap an async operation with a telemetry span. */
+    async instrument(operation, fn, seed = {}) {
+        const span = this.start(operation, seed);
+        try {
+            const result = await fn(span);
+            span.end();
+            return result;
+        }
+        catch (err) {
+            span.fail(err);
+            throw err;
+        }
+    }
+}
+/**
+ * Build a sink that forwards every event to an OpenTelemetry-compatible
+ * tracer (or any object with an `emit(event)` method). Use this to hook
+ * the SDK into your existing observability stack without building custom
+ * plumbing.
+ *
+ * @example
+ * ```ts
+ * const bridge = {
+ *   emit(event) {
+ *     tracer.startSpan(event.operation, { attributes: { ...event.attrs, duration_ms: event.duration_ms } }).end();
+ *   }
+ * };
+ * const telemetry = new TelemetryClient({ sink: openTelemetrySink(bridge) });
+ * ```
+ */
+export function openTelemetrySink(bridge) {
+    return (event) => {
+        try {
+            bridge.emit(event);
+        }
+        catch {
+            // swallow — telemetry must not break callers
+        }
+    };
+}
+/**
+ * Compose multiple sinks into one (fan-out). Every sink receives every
+ * event; failures in one don't block the others.
+ */
+export function multiSink(...sinks) {
+    return (event) => {
+        for (const sink of sinks) {
+            try {
+                sink(event);
+            }
+            catch {
+                // ignore per-sink failure
+            }
+        }
+    };
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/modules/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/modules/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA0EH,4CAA4C;AAC5C,MAAM,CAAC,MAAM,WAAW,GAAkB,CAAC,KAAK,EAAE,EAAE;IAClD,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,qCAAqC;IACvC,CAAC;AACH,CAAC,CAAC;AAEF,uEAAuE;AACvE,MAAM,CAAC,MAAM,QAAQ,GAAkB,GAAG,EAAE;IAC1C,mBAAmB;AACrB,CAAC,CAAC;AAEF,SAAS,cAAc;IACrB,MAAM,IAAI,GACR,OAAO,UAAU,CAAC,MAAM,EAAE,UAAU,KAAK,UAAU;QACjD,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE;QAChC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,QAAQ,IAAI,KAAK;QACjB,WAAW,IAAI,KAAK,CACrB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,eAAe;IACT,IAAI,CAAgB;IACpB,SAAS,CAA4C;IACrD,OAAO,CAAU;IAElC,YAAY,UAAkC,EAAE;QAC9C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QACpE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;IAC3C,CAAC;IAED,iFAAiF;IACjF,IAAI,CAAC,KAAqB;QACxB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,MAAM,MAAM,GAAmB;YAC7B,GAAG,KAAK;YACR,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE;SACrD,CAAC;QACF,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IAED,0FAA0F;IAC1F,KAAK,CACH,SAAiB,EACjB,OAAiF,EAAE;QAEnF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,cAAc,EAAE,CAAC;QAChD,IAAI,SAAS,GAA4B,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QACtE,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,MAAM,QAAQ,GAAG,CAAC,OAAyB,EAAE,QAAiC,EAAE,EAAQ,EAAE;YACxF,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM,MAAM,GAAmB;gBAC7B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,SAAS;gBACT,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBACnC,OAAO;gBACP,OAAO,EAAE,OAAO,KAAK,SAAS;gBAC9B,GAAG,SAAS;gBACZ,GAAG,KAAK;gBACR,KAAK,EAAE;oBACL,GAAG,IAAI,CAAC,SAAS;oBACjB,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC;oBAC1B,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;iBACvB;aACF,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC,CAAC;QAEF,OAAO;YACL,SAAS;YACT,MAAM;YACN,GAAG,CAAC,KAAK;gBACP,SAAS,GAAG;oBACV,GAAG,SAAS;oBACZ,GAAG,KAAK;oBACR,KAAK,EAAE,EAAE,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE;iBAC9D,CAAC;YACJ,CAAC;YACD,GAAG,CAAC,YAAY;gBACd,QAAQ,CAAC,SAAS,EAAE,YAAY,IAAI,EAAE,CAAC,CAAC;YAC1C,CAAC;YACD,IAAI,CAAC,KAAK,EAAE,YAAY;gBACtB,MAAM,QAAQ,GAA4B,EAAE,CAAC;gBAC7C,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC5B,QAAQ,CAAC,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC;oBACjC,QAAQ,CAAC,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC;oBACpC,QAAQ,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;oBACrC,IAAI,KAAK,CAAC,aAAa;wBAAE,QAAQ,CAAC,cAAc,GAAG,KAAK,CAAC,aAAa,CAAC;gBACzE,CAAC;qBAAM,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;oBAClC,QAAQ,CAAC,UAAU,GAAG,eAAe,CAAC;oBACtC,QAAQ,CAAC,KAAK,GAAG,EAAE,aAAa,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;gBACpD,CAAC;qBAAM,CAAC;oBACN,QAAQ,CAAC,UAAU,GAAG,eAAe,CAAC;gBACxC,CAAC;gBACD,QAAQ,CAAC,OAAO,EAAE,EAAE,GAAG,QAAQ,EAAE,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9D,CAAC;YACD,MAAM,CAAC,YAAY;gBACjB,QAAQ,CAAC,WAAW,EAAE,YAAY,IAAI,EAAE,CAAC,CAAC;YAC5C,CAAC;SACF,CAAC;IACJ,CAAC;IAED,qDAAqD;IACrD,KAAK,CAAC,UAAU,CACd,SAAiB,EACjB,EAAuC,EACvC,OAAiF,EAAE;QAEnF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,CAAC,GAAG,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACf,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;CACF;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA2B;IAC3D,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,6CAA6C;QAC/C,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,GAAG,KAAsB;IACjD,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,IAAI,CAAC,KAAK,CAAC,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,0BAA0B;YAC5B,CAAC;QACH,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}