@cursor/july 0.1.107 → 0.1.109

package/dist/internal/hosted-delivery-protocol.d.ts

@@ -5,10 +5,23 @@ export declare const HOSTED_EXECUTION_PATH = "/v1/internal/hosted-execution";
 export declare const HOSTED_GUEST_RETRY_TRANSIENT = "transient";
 export declare const HOSTED_GUEST_RETRY_TERMINAL = "terminal";
 export type HostedGuestRetryDisposition = typeof HOSTED_GUEST_RETRY_TRANSIENT | typeof HOSTED_GUEST_RETRY_TERMINAL;
+export declare const HOSTED_FAILURE_CLASSIFICATION_VERSION = 1;
+export type HostedFailureDomain = "configuration" | "protocol" | "platform" | "agent" | "dependency" | "cancellation" | "unknown";
+export type HostedFailureSource = "tas" | "factory" | "anyrun" | "engine" | "agent";
+export type HostedFailureClassification = {
+    v: typeof HOSTED_FAILURE_CLASSIFICATION_VERSION;
+    domain: HostedFailureDomain;
+    source: HostedFailureSource;
+};
+export type HostedFailureCode = "agent_admission_threw" | "agent_dependency_failed" | "background_dispatch_failed" | "bound_secrets_not_consumed" | "channel_dispatch_failed" | "channel_kind_mismatch" | "channel_not_found" | "channel_outcome_missing" | "forbidden" | "guest_connect_stalled" | "guest_network_unavailable" | "hosted_admission_session_mismatch" | "hosted_admission_unavailable" | "hosted_deferred_session_unusable" | "hosted_local_send_rejected" | "hosted_send_limit_exceeded" | "internal_error" | "invalid_hosted_admission" | "invalid_hosted_execution" | "invalid_request" | "method_not_allowed" | "not_found" | "session_busy" | "turn_cancelled" | "turn_failed" | "unauthorized" | "v2_identity_conflict";
+export declare const HOSTED_FAILURE_CLASSIFICATIONS: Record<HostedFailureCode, Omit<HostedFailureClassification, "v">>;
+export declare function hostedFailureClassification(code: string): HostedFailureClassification;
+export declare function parseHostedFailureClassification(value: unknown): HostedFailureClassification | undefined;
 export type HostedGuestError = {
     ok: false;
     error: string;
     retry: HostedGuestRetryDisposition;
+    classification: HostedFailureClassification;
     message?: string;
     turnStatus?: string;
 };
@@ -47,6 +60,29 @@ export type HostedReminderFirePayload = {
     reminderId: string;
     fireCount: number;
 };
+/** Protocol v1 immutable fire descriptor (architecture v2 CP path). */
+export type HostedReminderFireDescriptorPayload = {
+    protocolVersion: 1;
+    id: string;
+    fireCount: number;
+    generation: number;
+    purpose: string;
+    channelId: string;
+    continuationToken: string;
+    target?: Record<string, unknown>;
+    scheduleKind: "every" | "cron" | "delay" | "at";
+    scheduleValue: string;
+    intervalMs?: number;
+    prompt?: string;
+    handler?: string;
+    args?: Record<string, unknown>;
+    hasRunHandler: boolean;
+    hasUntilFn: boolean;
+    untilPrompt?: string;
+    busyPolicy: "skipIfBusy" | "queueBehindTurn";
+    nextFireAtMs: number;
+    claimedAtMs: number;
+};
 export type HostedAdmissionManagedAutomation = {
     automationUuid: string;
     mcpServerNames: string[];
@@ -105,5 +141,10 @@ export declare function isHostedReminderAdmission(delivery: HostedAdmission): bo
  * payload. Rejects unknown keys and non-integer fireCount.
  */
 export declare function parseHostedReminderFirePayload(value: unknown): HostedReminderFirePayload | undefined;
+/**
+ * Parse the immutable CP fire descriptor. Rejects unknown keys, non-enum
+ * schedule/busy values, and non-JSON-safe optional object fields.
+ */
+export declare function parseHostedReminderFireDescriptorPayload(value: unknown): HostedReminderFireDescriptorPayload | undefined;
 export declare function parseHostedAdmissionOutcome(value: unknown): HostedAdmissionOutcome | undefined;
 //# sourceMappingURL=hosted-delivery-protocol.d.ts.map

package/dist/internal/hosted-delivery-protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hosted-delivery-protocol.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-delivery-protocol.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hosted-delivery-protocol.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-delivery-protocol.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAClD,eAAO,MAAM,sBAAsB,gCAAgC,CAAC;AACpE,eAAO,MAAM,qBAAqB,kCAAkC,CAAC;AACrE,eAAO,MAAM,qBAAqB,kCAAkC,CAAC;AACrE,eAAO,MAAM,4BAA4B,cAAc,CAAC;AACxD,eAAO,MAAM,2BAA2B,aAAa,CAAC;AAEtD,MAAM,MAAM,2BAA2B,GACnC,OAAO,4BAA4B,GACnC,OAAO,2BAA2B,CAAC;AAEvC,eAAO,MAAM,qCAAqC,IAAI,CAAC;AAEvD,MAAM,MAAM,mBAAmB,GAC3B,eAAe,GACf,UAAU,GACV,UAAU,GACV,OAAO,GACP,YAAY,GACZ,cAAc,GACd,SAAS,CAAC;AAEd,MAAM,MAAM,mBAAmB,GAC3B,KAAK,GACL,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,OAAO,CAAC;AAEZ,MAAM,MAAM,2BAA2B,GAAG;IACxC,CAAC,EAAE,OAAO,qCAAqC,CAAC;IAChD,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAmBF,MAAM,MAAM,iBAAiB,GACzB,uBAAuB,GACvB,yBAAyB,GACzB,4BAA4B,GAC5B,4BAA4B,GAC5B,yBAAyB,GACzB,uBAAuB,GACvB,mBAAmB,GACnB,yBAAyB,GACzB,WAAW,GACX,uBAAuB,GACvB,2BAA2B,GAC3B,mCAAmC,GACnC,8BAA8B,GAC9B,kCAAkC,GAClC,4BAA4B,GAC5B,4BAA4B,GAC5B,gBAAgB,GAChB,0BAA0B,GAC1B,0BAA0B,GAC1B,iBAAiB,GACjB,oBAAoB,GACpB,WAAW,GACX,cAAc,GACd,gBAAgB,GAChB,aAAa,GACb,cAAc,GACd,sBAAsB,CAAC;AAE3B,eAAO,MAAM,8BAA8B,EAAE,MAAM,CACjD,iBAAiB,EACjB,IAAI,CAAC,2BAA2B,EAAE,GAAG,CAAC,CA6BvC,CAAC;AAEF,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,GACX,2BAA2B,CAO7B;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,OAAO,GACb,2BAA2B,GAAG,SAAS,CAezC;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,2BAA2B,CAAC;IACnC,cAAc,EAAE,2BAA2B,CAAC;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,2BAA2B,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,QAAQ,CAUX;AAED;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,0BAA0B,CAAC;AAEtE;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,uBAAuB,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,0BAA0B,4BAA4B,CAAC;AAEpE,2EAA2E;AAC3E,MAAM,MAAM,yBAAyB,GAAG;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,uEAAuE;AACvE,MAAM,MAAM,mCAAmC,GAAG;IAChD,eAAe,EAAE,CAAC,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,YAAY,GAAG,iBAAiB,CAAC;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,CAAC,EAAE,CAAC,CAAC;IACL,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,GAAG,cAAc,CAAC;IACtC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,gCAAgC,CAAC;CACtD,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAC9B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,CAAC,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAC5C;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,CAAC,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE,MAAM,MAAM,eAAe,GAAG;IAC5B,CAAC,EAAE,CAAC,CAAC;IACL,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,IAAI,CAAC;IACT,CAAC,EAAE,CAAC,CAAC;IACL,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAyEF,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,GACb,eAAe,GAAG,SAAS,CAuB7B;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,GACb,eAAe,GAAG,SAAS,CAe7B;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAK5E;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,GACb,yBAAyB,GAAG,SAAS,CAqBvC;AA0GD;;;GAGG;AACH,wBAAgB,wCAAwC,CACtD,KAAK,EAAE,OAAO,GACb,mCAAmC,GAAG,SAAS,CAoHjD;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,GACb,sBAAsB,GAAG,SAAS,CAkBpC"}

package/dist/internal/hosted-delivery-protocol.js

@@ -4,6 +4,75 @@ export const HOSTED_ADMISSION_PATH = "/v1/internal/hosted-admission";
 export const HOSTED_EXECUTION_PATH = "/v1/internal/hosted-execution";
 export const HOSTED_GUEST_RETRY_TRANSIENT = "transient";
 export const HOSTED_GUEST_RETRY_TERMINAL = "terminal";
+export const HOSTED_FAILURE_CLASSIFICATION_VERSION = 1;
+const HOSTED_FAILURE_DOMAINS = new Set([
+    "configuration",
+    "protocol",
+    "platform",
+    "agent",
+    "dependency",
+    "cancellation",
+    "unknown",
+]);
+const HOSTED_FAILURE_SOURCES = new Set([
+    "tas",
+    "factory",
+    "anyrun",
+    "engine",
+    "agent",
+]);
+export const HOSTED_FAILURE_CLASSIFICATIONS = {
+    agent_admission_threw: { domain: "agent", source: "agent" },
+    agent_dependency_failed: { domain: "dependency", source: "factory" },
+    background_dispatch_failed: { domain: "agent", source: "agent" },
+    bound_secrets_not_consumed: { domain: "platform", source: "engine" },
+    channel_dispatch_failed: { domain: "agent", source: "agent" },
+    channel_kind_mismatch: { domain: "configuration", source: "engine" },
+    channel_not_found: { domain: "configuration", source: "engine" },
+    channel_outcome_missing: { domain: "protocol", source: "agent" },
+    forbidden: { domain: "configuration", source: "engine" },
+    guest_connect_stalled: { domain: "platform", source: "engine" },
+    guest_network_unavailable: { domain: "platform", source: "anyrun" },
+    hosted_admission_session_mismatch: { domain: "protocol", source: "engine" },
+    hosted_admission_unavailable: { domain: "platform", source: "engine" },
+    hosted_deferred_session_unusable: { domain: "agent", source: "agent" },
+    hosted_local_send_rejected: { domain: "agent", source: "agent" },
+    hosted_send_limit_exceeded: { domain: "agent", source: "agent" },
+    internal_error: { domain: "unknown", source: "engine" },
+    invalid_hosted_admission: { domain: "protocol", source: "engine" },
+    invalid_hosted_execution: { domain: "protocol", source: "engine" },
+    invalid_request: { domain: "protocol", source: "engine" },
+    method_not_allowed: { domain: "protocol", source: "engine" },
+    not_found: { domain: "protocol", source: "engine" },
+    session_busy: { domain: "platform", source: "engine" },
+    turn_cancelled: { domain: "cancellation", source: "agent" },
+    turn_failed: { domain: "agent", source: "agent" },
+    unauthorized: { domain: "configuration", source: "engine" },
+    v2_identity_conflict: { domain: "protocol", source: "engine" },
+};
+export function hostedFailureClassification(code) {
+    var _a, _b;
+    const known = HOSTED_FAILURE_CLASSIFICATIONS[code];
+    return {
+        v: HOSTED_FAILURE_CLASSIFICATION_VERSION,
+        domain: (_a = known === null || known === void 0 ? void 0 : known.domain) !== null && _a !== void 0 ? _a : "unknown",
+        source: (_b = known === null || known === void 0 ? void 0 : known.source) !== null && _b !== void 0 ? _b : "engine",
+    };
+}
+export function parseHostedFailureClassification(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return undefined;
+    }
+    const body = value;
+    if (body.v !== HOSTED_FAILURE_CLASSIFICATION_VERSION ||
+        typeof body.domain !== "string" ||
+        !HOSTED_FAILURE_DOMAINS.has(body.domain) ||
+        typeof body.source !== "string" ||
+        !HOSTED_FAILURE_SOURCES.has(body.source)) {
+        return undefined;
+    }
+    return body;
+}
 /**
  * Hosted delivery is the only HTTP surface whose failures drive Temporal
  * retries. Keep its retry disposition explicit instead of making the shared
@@ -14,6 +83,7 @@ export function hostedGuestErrorResponse(input) {
         ok: false,
         error: input.error,
         retry: input.retry,
+        classification: hostedFailureClassification(input.error),
         message: input.message,
         turnStatus: input.turnStatus,
     };
@@ -163,6 +233,185 @@ export function parseHostedReminderFirePayload(value) {
         fireCount: body.fireCount,
     };
 }
+const HOSTED_REMINDER_FIRE_DESCRIPTOR_KEYS = new Set([
+    "protocolVersion",
+    "id",
+    "fireCount",
+    "generation",
+    "purpose",
+    "channelId",
+    "continuationToken",
+    "target",
+    "scheduleKind",
+    "scheduleValue",
+    "intervalMs",
+    "prompt",
+    "handler",
+    "args",
+    "hasRunHandler",
+    "hasUntilFn",
+    "untilPrompt",
+    "busyPolicy",
+    "nextFireAtMs",
+    "claimedAtMs",
+]);
+const HOSTED_REMINDER_SCHEDULE_KINDS = new Set([
+    "every",
+    "cron",
+    "delay",
+    "at",
+]);
+const HOSTED_REMINDER_BUSY_POLICIES = new Set([
+    "skipIfBusy",
+    "queueBehindTurn",
+]);
+const HOSTED_REMINDER_JSON_MAX_DEPTH = 8;
+/** Reject non-JSON values (NaN/Infinity/undefined/bigint/function/symbol). */
+function isJsonSafeValue(value, depth) {
+    if (depth > HOSTED_REMINDER_JSON_MAX_DEPTH) {
+        return false;
+    }
+    if (value === null) {
+        return true;
+    }
+    const type = typeof value;
+    if (type === "string" || type === "boolean") {
+        return true;
+    }
+    if (type === "number") {
+        return Number.isFinite(value);
+    }
+    if (type !== "object") {
+        return false;
+    }
+    if (Array.isArray(value)) {
+        return value.every((entry) => isJsonSafeValue(entry, depth + 1));
+    }
+    const proto = Object.getPrototypeOf(value);
+    if (proto !== Object.prototype && proto !== null) {
+        return false;
+    }
+    for (const entry of Object.values(value)) {
+        if (!isJsonSafeValue(entry, depth + 1)) {
+            return false;
+        }
+    }
+    return true;
+}
+function parseOptionalJsonObjectField(value, maxBytes) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return undefined;
+    }
+    if (!isJsonSafeValue(value, 0)) {
+        return undefined;
+    }
+    try {
+        const encoded = JSON.stringify(value);
+        if (encoded === undefined ||
+            Buffer.byteLength(encoded, "utf8") > maxBytes) {
+            return undefined;
+        }
+        const roundTrip = JSON.parse(encoded);
+        if (typeof roundTrip !== "object" ||
+            roundTrip === null ||
+            Array.isArray(roundTrip)) {
+            return undefined;
+        }
+        return roundTrip;
+    }
+    catch (_a) {
+        return undefined;
+    }
+}
+/**
+ * Parse the immutable CP fire descriptor. Rejects unknown keys, non-enum
+ * schedule/busy values, and non-JSON-safe optional object fields.
+ */
+export function parseHostedReminderFireDescriptorPayload(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return undefined;
+    }
+    const body = value;
+    if (Object.keys(body).some((key) => !HOSTED_REMINDER_FIRE_DESCRIPTOR_KEYS.has(key))) {
+        return undefined;
+    }
+    if (body.protocolVersion !== 1 ||
+        typeof body.id !== "string" ||
+        body.id.length === 0 ||
+        body.id.length > 128 ||
+        typeof body.fireCount !== "number" ||
+        !Number.isInteger(body.fireCount) ||
+        body.fireCount < 0 ||
+        typeof body.generation !== "number" ||
+        !Number.isInteger(body.generation) ||
+        body.generation < 0 ||
+        typeof body.purpose !== "string" ||
+        body.purpose.length === 0 ||
+        body.purpose.length > 512 ||
+        typeof body.channelId !== "string" ||
+        body.channelId.length === 0 ||
+        body.channelId.length > 128 ||
+        typeof body.continuationToken !== "string" ||
+        body.continuationToken.length === 0 ||
+        body.continuationToken.length > 512 ||
+        typeof body.scheduleKind !== "string" ||
+        !HOSTED_REMINDER_SCHEDULE_KINDS.has(body.scheduleKind) ||
+        typeof body.scheduleValue !== "string" ||
+        body.scheduleValue.length === 0 ||
+        body.scheduleValue.length > 512 ||
+        typeof body.hasRunHandler !== "boolean" ||
+        typeof body.hasUntilFn !== "boolean" ||
+        typeof body.busyPolicy !== "string" ||
+        !HOSTED_REMINDER_BUSY_POLICIES.has(body.busyPolicy) ||
+        typeof body.nextFireAtMs !== "number" ||
+        !Number.isFinite(body.nextFireAtMs) ||
+        typeof body.claimedAtMs !== "number" ||
+        !Number.isFinite(body.claimedAtMs) ||
+        !Number.isInteger(body.claimedAtMs) ||
+        body.claimedAtMs < 0) {
+        return undefined;
+    }
+    if (body.intervalMs !== undefined) {
+        if (typeof body.intervalMs !== "number" ||
+            !Number.isFinite(body.intervalMs) ||
+            !Number.isInteger(body.intervalMs) ||
+            body.intervalMs <= 0) {
+            return undefined;
+        }
+    }
+    if (body.prompt !== undefined) {
+        if (typeof body.prompt !== "string" || body.prompt.length > 8192) {
+            return undefined;
+        }
+    }
+    if (body.handler !== undefined) {
+        if (typeof body.handler !== "string" ||
+            body.handler.length === 0 ||
+            body.handler.length > 128) {
+            return undefined;
+        }
+    }
+    if (body.untilPrompt !== undefined) {
+        if (typeof body.untilPrompt !== "string" ||
+            body.untilPrompt.length > 8192) {
+            return undefined;
+        }
+    }
+    const target = parseOptionalJsonObjectField(body.target, 16 * 1024);
+    if (body.target !== undefined && target === undefined) {
+        return undefined;
+    }
+    const args = parseOptionalJsonObjectField(body.args, 32 * 1024);
+    if (body.args !== undefined && args === undefined) {
+        return undefined;
+    }
+    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ protocolVersion: 1, id: body.id, fireCount: body.fireCount, generation: body.generation, purpose: body.purpose, channelId: body.channelId, continuationToken: body.continuationToken }, (target === undefined ? {} : { target })), { scheduleKind: body.scheduleKind, scheduleValue: body.scheduleValue }), (body.intervalMs === undefined ? {} : { intervalMs: body.intervalMs })), (body.prompt === undefined ? {} : { prompt: body.prompt })), (body.handler === undefined ? {} : { handler: body.handler })), (args === undefined ? {} : { args })), { hasRunHandler: body.hasRunHandler, hasUntilFn: body.hasUntilFn }), (body.untilPrompt === undefined
+        ? {}
+        : { untilPrompt: body.untilPrompt })), { busyPolicy: body.busyPolicy, nextFireAtMs: body.nextFireAtMs, claimedAtMs: body.claimedAtMs });
+}
 export function parseHostedAdmissionOutcome(value) {
     if (typeof value !== "object" || value === null || Array.isArray(value)) {
         return undefined;

package/dist/internal/hosted-delivery.d.ts

@@ -1,7 +1,7 @@
 import type { ChannelHandlerArgs, SendMessageOptions } from "../types.js";
 import { type HostedBoundSecretsResult } from "./cursor/hosted-bound-secrets.js";
 import { type GuestNetworkWaitResult } from "./guest-network.js";
-import { type HostedAdmission } from "./hosted-delivery-protocol.js";
+import { type HostedAdmission, type HostedReminderFireDescriptorPayload } from "./hosted-delivery-protocol.js";
 import type { LogRingEntry } from "./log-ring.js";
 import type { Router } from "./router.js";
 import type { SessionRunExecutionWrite } from "./session-run-log.js";
@@ -49,6 +49,15 @@ export declare function registerHostedDeliveryRoute(input: {
         outcome: "fired" | "noop";
         reason?: string;
     }>;
+    /**
+     * Architecture v2: execute an immutable CP fire descriptor and apply the
+     * structured outcome via the hosted ReminderControlPlane client.
+     */
+    executeReminderDescriptor?(descriptor: HostedReminderFireDescriptorPayload): Promise<{
+        reminderId: string;
+        outcome: "fired" | "noop";
+        reason?: string;
+    }>;
     /**
      * Await the session's durable mirror (dispatch chain + storage queue)
      * before the execution reply: the control plane may park the pod the

package/dist/internal/hosted-delivery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hosted-delivery.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-delivery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,kCAAkC,CAAC;AAK1C,OAAO,EAKL,KAAK,sBAAsB,EAI5B,MAAM,oBAAoB,CAAC;AAS5B,OAAO,EAOL,KAAK,eAAe,EAOrB,MAAM,+BAA+B,CAAC;AAYvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAOlD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAErE,KAAK,aAAa,GAAG;IACnB,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,kBAAkB,CAAC;CAC1B,CAAC;AAEF,KAAK,WAAW,GAAG;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,sBAAsB,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,CAAC;AAuFF;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAU5B;AA+ND,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,gBAAgB,CACd,SAAS,EAAE,MAAM,EACjB,eAAe,CAAC,EAAE,MAAM,GACvB,kBAAkB,CAAC;IACtB;;;;OAIG;IACH,YAAY,CAAC,CACX,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC;QACT,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH;;;;;OAKG;IACH,sBAAsB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D;;;OAGG;IACH,SAAS,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,iBAAiB,CAAC,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,8DAA8D;IAC9D,aAAa,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,wDAAwD;IACxD,YAAY,CAAC,IAAI,YAAY,EAAE,CAAC;IAChC;;;;;OAKG;IACH,eAAe,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C;;;OAGG;IACH,mBAAmB,CAAC,IAAI,OAAO,CAAC,sBAAsB,GAAG,OAAO,CAAC,CAAC;IAClE;;;;OAIG;IACH,mBAAmB,CAAC,IAAI,wBAAwB,CAAC;CAClD,GAAG,IAAI,CAwWP"}
+{"version":3,"file":"hosted-delivery.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-delivery.ts"],"names":[],"mappings":"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"}

package/dist/internal/hosted-delivery.js

@@ -11,17 +11,17 @@ import { randomBytes } from "node:crypto";
 import { dispatchOutcome } from "./channel-dispatch.js";
 import { consumeHostedBoundSecrets, } from "./cursor/hosted-bound-secrets.js";
 import { createDeferredChannelSession, DeferredChannelSessionError, } from "./deferred-channel-session.js";
-import { formatGuestNetworkServerTiming, GUEST_CONNECT_STALLED, GUEST_NETWORK_UNAVAILABLE, GuestNetworkUnavailableError, isQuietGuestConnectStallMessage, waitForGuestNetworkReady, } from "./guest-network.js";
+import { formatGuestNetworkServerTiming, GUEST_CONNECT_STALLED, GUEST_NETWORK_UNAVAILABLE, GuestNetworkUnavailableError, waitForGuestNetworkReady, } from "./guest-network.js";
 import { getHostedAdmissionAdapter, } from "./hosted-admission-adapter.js";
 import { HostedAdmissionLocalSendError, runDuringHostedAdmission, } from "./hosted-admission-context.js";
-import { HOSTED_ADMISSION_PATH, HOSTED_DELIVERY_HEADER, HOSTED_DELIVERY_PROTOCOL_VERSION, HOSTED_EXECUTION_PATH, HOSTED_GUEST_RETRY_TERMINAL, HOSTED_GUEST_RETRY_TRANSIENT, hostedGuestErrorResponse, isHostedReminderAdmission, parseHostedAdmission, parseHostedExecution, parseHostedReminderFirePayload, } from "./hosted-delivery-protocol.js";
+import { HOSTED_ADMISSION_PATH, HOSTED_DELIVERY_HEADER, HOSTED_DELIVERY_PROTOCOL_VERSION, HOSTED_EXECUTION_PATH, HOSTED_GUEST_RETRY_TERMINAL, HOSTED_GUEST_RETRY_TRANSIENT, hostedFailureClassification, hostedGuestErrorResponse, isHostedReminderAdmission, parseHostedAdmission, parseHostedExecution, parseHostedReminderFireDescriptorPayload, parseHostedReminderFirePayload, } from "./hosted-delivery-protocol.js";
 import { abortReasonFromTurnStatus, HOSTED_EXECUTION_DIAG_RUNNING_STATUS, hostedExecutionDiagId, } from "./hosted-execution-diag.js";
 import { flushHostedExecutionRecord, } from "./hosted-execution-flush.js";
 import { recordHostedManagedAutomation } from "./hosted-managed-automation.js";
 import { readJsonObject } from "./http-channel.js";
 import { endActiveHttpSpan } from "./otel/http.js";
 import { ReminderValidationError, UnknownReminderError, } from "./reminder-runner.js";
-import { statusForThrownRequestError } from "./request-error-status.js";
+import { mapThrownRequestError, statusForThrownRequestError, } from "./request-error-status.js";
 /**
  * A second `send()` in one delivery is a deterministic authored bug — the
  * wire protocol carries exactly one pending send per delivery — so it must
@@ -81,6 +81,30 @@ function nonRetryableRejection(error) {
         response: terminalHostedError(422, code, boundedMessage(error.message)),
     };
 }
+/**
+ * Prefer the shared throw → HTTP mapper (guest network / connect stall /
+ * session busy / …) before collapsing into agent_admission_threw or
+ * background_dispatch_failed. Those agent codes otherwise hide typed
+ * transient failures that the outer handleRequest boundary never sees.
+ */
+function mappedAdmissionFailure(error) {
+    const rejected = nonRetryableRejection(error);
+    if (rejected !== undefined) {
+        return rejected;
+    }
+    const mapped = mapThrownRequestError(error);
+    if (mapped === undefined) {
+        return undefined;
+    }
+    return {
+        response: hostedGuestErrorResponse({
+            status: mapped.status,
+            error: mapped.code,
+            retry: mapped.retry,
+            message: boundedMessage(mapped.message),
+        }),
+    };
+}
 /**
  * Run authored admission without creating a framework session. Authored
  * `task` callbacks execute as sessionless work; the first `send` is captured
@@ -112,12 +136,37 @@ export function dispatchHostedAdmission(input) {
  */
 function dispatchHostedReminderAdmission(input, delivery) {
     return __awaiter(this, void 0, void 0, function* () {
+        const descriptor = parseHostedReminderFireDescriptorPayload(delivery.payload);
+        if (descriptor !== undefined) {
+            if (input.executeReminderDescriptor === undefined) {
+                return transientHostedError(503, "reminder_dispatch_unavailable", "This guest has no reminder CP executor wired for hosted admission.");
+            }
+            try {
+                const result = yield input.executeReminderDescriptor(descriptor);
+                const outcome = result.outcome === "noop" ? "skip" : "task";
+                return Response.json({
+                    ok: true,
+                    v: HOSTED_DELIVERY_PROTOCOL_VERSION,
+                    outcome,
+                });
+            }
+            catch (error) {
+                if (error instanceof UnknownReminderError) {
+                    return terminalHostedError(404, "unknown_reminder", boundedMessage(error.message));
+                }
+                if (error instanceof ReminderValidationError) {
+                    return terminalHostedError(400, "invalid_reminder", boundedMessage(error.message));
+                }
+                // Transient CP apply/fetch failures must remain retryable.
+                throw error;
+            }
+        }
         if (input.fireReminder === undefined) {
             return transientHostedError(503, "reminder_dispatch_unavailable", "This guest has no reminder runner wired for hosted admission.");
         }
         const payload = parseHostedReminderFirePayload(delivery.payload);
         if (payload === undefined) {
-            return terminalHostedError(400, "invalid_reminder_payload", "Expected reminder payload { reminderId, fireCount }.");
+            return terminalHostedError(400, "invalid_reminder_payload", "Expected reminder descriptor or legacy payload { reminderId, fireCount }.");
         }
         try {
             const result = yield input.fireReminder(payload.reminderId, payload.fireCount);
@@ -158,6 +207,7 @@ function runAdmission(input, adapter) {
         let dispatched;
         try {
             dispatched = yield adapter.dispatch({
+                channelId: input.delivery.channelId,
                 eventType: input.delivery.eventType,
                 payload: input.delivery.payload,
                 deliveryId: input.delivery.deliveryId,
@@ -165,11 +215,13 @@ function runAdmission(input, adapter) {
             });
         }
         catch (error) {
-            const rejected = nonRetryableRejection(error);
-            if (rejected !== undefined) {
-                return rejected;
+            const mapped = mappedAdmissionFailure(error);
+            if (mapped !== undefined) {
+                return mapped;
             }
-            throw error;
+            return {
+                response: terminalHostedError(500, "agent_admission_threw", boundedMessage(error instanceof Error ? error.message : String(error))),
+            };
         }
         if (!dispatched.ok) {
             return {
@@ -180,9 +232,9 @@ function runAdmission(input, adapter) {
             yield Promise.all(background);
         }
         catch (error) {
-            const rejected = nonRetryableRejection(error);
-            if (rejected !== undefined) {
-                return rejected;
+            const mapped = mappedAdmissionFailure(error);
+            if (mapped !== undefined) {
+                return mapped;
             }
             return {
                 response: terminalHostedError(503, "background_dispatch_failed", boundedMessage(error instanceof Error ? error.message : String(error))),
@@ -441,11 +493,14 @@ export function registerHostedDeliveryRoute(input) {
                         ? {}
                         : { snapshotLogs: input.snapshotLogs }));
                     const writeDiag = (fields) => __awaiter(this, void 0, void 0, function* () {
-                        yield flushHostedExecutionRecord(sinks, Object.assign(Object.assign(Object.assign({ executionId, sessionPublicId: execution.sessionPublicId, sessionId: fields.sessionId, turnStatus: fields.turnStatus, durationMs: Math.max(0, Math.round(performance.now() - startedAt)) }, (fields.message === undefined
+                        const classification = fields.failureCode === undefined
+                            ? undefined
+                            : hostedFailureClassification(fields.failureCode);
+                        yield flushHostedExecutionRecord(sinks, Object.assign(Object.assign(Object.assign(Object.assign({ executionId, sessionPublicId: execution.sessionPublicId, sessionId: fields.sessionId, turnStatus: fields.turnStatus, durationMs: Math.max(0, Math.round(performance.now() - startedAt)) }, (fields.message === undefined
                             ? {}
                             : { message: fields.message })), (fields.abortReason === undefined
                             ? {}
-                            : { abortReason: fields.abortReason })), (fields.error === undefined ? {} : { error: fields.error })));
+                            : { abortReason: fields.abortReason })), { failureCode: fields.failureCode, classification }), (fields.error === undefined ? {} : { error: fields.error })));
                     });
                     // Claim the file before the turn runs. The host reads it after its
                     // own POST returns, which for a 9-minute timeout is while this turn
@@ -470,23 +525,24 @@ export function registerHostedDeliveryRoute(input) {
                         // as soon as the POST returns. A leftover SDK handle freezes a
                         // dead Connect/HTTP2 session that the next wake then reuses.
                         evictHostedSdkSessions(input.evictSdkSession, session.id, execution.sessionPublicId);
+                        const hostedFailure = outcome.status === "finished"
+                            ? undefined
+                            : hostedFailureForUnfinishedTurn(outcome);
                         yield writeDiag({
                             sessionId: session.id,
                             turnStatus: outcome.status,
                             message: outcome.errorMessage,
-                            abortReason: abortReasonFromTurnStatus(outcome.status, outcome.errorMessage),
+                            abortReason: abortReasonFromTurnStatus(outcome.status, outcome.cancellationReason),
+                            failureCode: hostedFailure === null || hostedFailure === void 0 ? void 0 : hostedFailure.error,
                         });
-                        if (outcome.status !== "finished") {
-                            // waitForCompletion resolves (does not throw) on a quiet
-                            // Connect abort. Map that to guest_connect_stalled so TAS
-                            // retries the same pod. Real runner failures stay turn_failed.
-                            const hostedFailure = hostedFailureForUnfinishedTurn(outcome.errorMessage);
+                        if (hostedFailure !== undefined) {
                             return {
                                 status: 503,
                                 body: {
                                     ok: false,
                                     error: hostedFailure.error,
                                     retry: hostedFailure.retry,
+                                    classification: hostedFailureClassification(hostedFailure.error),
                                     turnStatus: outcome.status,
                                     message: outcome.errorMessage,
                                 },
@@ -508,6 +564,7 @@ export function registerHostedDeliveryRoute(input) {
                             turnStatus: "error",
                             message: error instanceof Error ? error.message : String(error),
                             abortReason: "execute_throw",
+                            failureCode: "internal_error",
                             error,
                         });
                         throw error;
@@ -532,14 +589,35 @@ function evictHostedSdkSessions(evict, ...ids) {
         evict(id);
     }
 }
-function hostedFailureForUnfinishedTurn(errorMessage) {
-    if (errorMessage !== undefined &&
-        isQuietGuestConnectStallMessage(errorMessage)) {
+const TRANSIENT_TURN_ERROR_CODES = new Set([
+    "ABORT_ERR",
+    "UND_ERR_BODY_TIMEOUT",
+    "UND_ERR_HEADERS_TIMEOUT",
+    "canceled",
+    "unavailable",
+    "unknown",
+]);
+function hostedFailureForUnfinishedTurn(outcome) {
+    if (outcome.errorCode === "agent_dependency_failed") {
+        return {
+            error: "agent_dependency_failed",
+            retry: HOSTED_GUEST_RETRY_TERMINAL,
+        };
+    }
+    if (outcome.status === "error" &&
+        outcome.errorCode !== undefined &&
+        TRANSIENT_TURN_ERROR_CODES.has(outcome.errorCode)) {
         return {
             error: GUEST_CONNECT_STALLED,
             retry: HOSTED_GUEST_RETRY_TRANSIENT,
         };
     }
+    if (outcome.status === "cancelled") {
+        return {
+            error: "turn_cancelled",
+            retry: HOSTED_GUEST_RETRY_TERMINAL,
+        };
+    }
     return { error: "turn_failed", retry: HOSTED_GUEST_RETRY_TERMINAL };
 }
 function afterHostedWork(flushOtel, work) {

package/dist/internal/hosted-execution-diag.d.ts

@@ -3,6 +3,7 @@
  * session-run document and the `start.log` tee by
  * `hosted-execution-flush.ts`.
  */
+import { type HostedFailureClassification } from "./hosted-delivery-protocol.js";
 export declare const HOSTED_EXECUTION_DIAG_VERSION = 1;
 /** Cap so a runaway message cannot fill the guest disk or the host log. */
 export declare const HOSTED_EXECUTION_DIAG_MAX_BYTES = 4096;
@@ -41,6 +42,8 @@ export type HostedExecutionDiag = {
     signalAborted?: boolean;
     requestId?: string;
     abortReason?: HostedExecutionDiagAbortReason;
+    failureCode?: string;
+    classification?: HostedFailureClassification;
 };
 /** Written before the turn starts so a stalled execution still has a record. */
 export declare const HOSTED_EXECUTION_DIAG_RUNNING_STATUS = "running";
@@ -54,7 +57,7 @@ export declare const HOSTED_ERROR_SNIPPET_MAX_CHARS = 700;
  */
 export declare function hostedErrorStackSnippet(error: unknown): string;
 export declare function hostedExecutionDiagPath(stateRoot: string): string;
-export declare function abortReasonFromTurnStatus(status: string, message: string | undefined): HostedExecutionDiagAbortReason | undefined;
+export declare function abortReasonFromTurnStatus(status: string, cancellationReason: "signal" | "runner" | undefined): HostedExecutionDiagAbortReason | undefined;
 export declare function parseHostedExecutionDiag(raw: string): HostedExecutionDiag | undefined;
 /**
  * Overwrite the per-execution diag file. Soft-fail: a write error must not

package/dist/internal/hosted-execution-diag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hosted-execution-diag.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-execution-diag.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,2EAA2E;AAC3E,eAAO,MAAM,+BAA+B,OAAO,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,MAAM,MAAM,8BAA8B,GACtC,cAAc,GACd,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,CAAC,EAAE,OAAO,6BAA6B,CAAC;IACxC,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,8BAA8B,CAAC;CAC9C,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,oCAAoC,YAAY,CAAC;AAmC9D,iFAAiF;AACjF,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAyB9D;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,8BAA8B,GAAG,SAAS,CAU5C;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,GACV,mBAAmB,GAAG,SAAS,CA2EjC;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CAmBf"}
+{"version":3,"file":"hosted-execution-diag.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-execution-diag.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAEL,KAAK,2BAA2B,EAEjC,MAAM,+BAA+B,CAAC;AAEvC,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,2EAA2E;AAC3E,eAAO,MAAM,+BAA+B,OAAO,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,MAAM,MAAM,8BAA8B,GACtC,cAAc,GACd,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,CAAC,EAAE,OAAO,6BAA6B,CAAC;IACxC,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,8BAA8B,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,2BAA2B,CAAC;CAC9C,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,oCAAoC,YAAY,CAAC;AAqC9D,iFAAiF;AACjF,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAyB9D;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAClD,8BAA8B,GAAG,SAAS,CAU5C;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,GACV,mBAAmB,GAAG,SAAS,CAqFjC;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CAmBf"}