@cursor/july 0.1.80 → 0.1.82

package/dist/files.js

@@ -49,14 +49,20 @@ export const fileKeys = {
 };
 /**
  * Framework-owned keys for state that lives on the deployment's Agent Store
- * but is not author `host.files` data: artifact rows and payloads, and the
- * cross-session memory journal. Kept out of `files/` so author listings never
- * see framework rows.
+ * but is not author `host.files` data: artifact rows and payloads, authored
+ * skills synced for cloud turns, and the cross-session memory journal. Kept
+ * out of `files/` so author listings never see framework rows.
+ *
+ * Skills sit at store-root `skills/<name>/…` so exec-daemon's
+ * `--agent-store-skills-dir` walk finds them the same way it finds user-store
+ * skills. Memory and artifacts stay under {@link STORAGE_KEY_ROOT}.
  */
 export const agentStoreKeys = {
     artifactRow: (agent, id) => `${STORAGE_KEY_ROOT}/${agent}/artifacts/rows/${encodeURIComponent(id)}.json`,
     artifactRowPrefix: (agent) => `${STORAGE_KEY_ROOT}/${agent}/artifacts/rows/`,
     artifactContent: (agent, id) => `${STORAGE_KEY_ROOT}/${agent}/artifacts/content/${encodeURIComponent(id)}`,
+    skillFile: (skillName, relPath) => `skills/${skillName}/${relPath}`,
+    skillsPrefix: () => "skills/",
     memoryDir: (agent) => `${STORAGE_KEY_ROOT}/${agent}/memory`,
     memoryJournal: (agent) => `${STORAGE_KEY_ROOT}/${agent}/memory/journal.jsonl`,
     memoryJournalRotated: (agent, stamp) => `${STORAGE_KEY_ROOT}/${agent}/memory/journal-${stamp}.jsonl`,

package/dist/index.d.ts

@@ -18,6 +18,8 @@ export { defineAB } from "./ab.js";
 export { defineArtifacts } from "./artifacts.js";
 export { allowAll, bearerAuth, DELETE, defineChannel, GET, httpChannel, localDev, localDevStrict, loopbackGitHubDev, loopbackOnly, PATCH, POST, PUT, publicEndpoint, } from "./channels.js";
 export { defineConnection } from "./connections.js";
+export type { ContinuationBuiltin, ContinuationClaim, ContinuationIdentity, ContinuationSelector, ConversationType, MailboxContinuation, ParsedContinuation, } from "./continuation.js";
+export { BUILTINS, bindMailboxContinuationSend, CONTINUATION_SELECTORS, continuationSource, defaultContinuationSelector, extractContinuation, formatConversationKey, handshakeContinuation, isContinuationSelector, mintClaim, normalizeIdentity, parseContinuationSelector, resolveContinuation, resolveV2Key, stampMailboxContinuation, V2EngineError, } from "./continuation.js";
 export { defineHook } from "./hooks.js";
 export type { LoadAgentProjectOptions } from "./internal/discovery.js";
 export { formatDiagnostics, hasErrorDiagnostics, isAgentProjectDir, loadAgentProject, loadAgentProjects, projectInfo, resolveAgentMounts, } from "./internal/discovery.js";
@@ -44,7 +46,9 @@ export type * from "./types.js";
 export { cursorAccountServersHasMixedWildcard, DEFAULT_MODEL, DIRECT_TOOL_CALL_CHANNEL_ID, isCursorAccountTransport, isPeerConnectionTransport, isSymbolicConnectionTransport, MAX_RUNNING_TURNS_LIMIT, normalizeCursorAccountServers, supportsKvCas, } from "./types.js";
 /**
  * Runtime config for an agent — authored at `agent/agent.ts` (the root
- * agent) or `agent/subagents/<id>/agent.ts` (a subagent).
+ * agent) or `agent/subagents/<id>/agent.ts` (a subagent). Set
+ * `architecture: "v2"` to deploy onto the v2 control plane; omitted
+ * channel continuation then inherits kind `/v2` defaults.
  */
 export declare function defineAgent(config: AgentConfig): AgentConfigDefinition;
 /**

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EACV,WAAW,EACX,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EACL,QAAQ,EACR,UAAU,EACV,MAAM,EACN,aAAa,EACb,GAAG,EACH,WAAW,EACX,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,KAAK,EACL,IAAI,EACJ,GAAG,EACH,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,4BAA4B,EAC5B,6BAA6B,EAC7B,4BAA4B,EAC5B,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,4BAA4B,EAC5B,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,UAAU,EACV,cAAc,EACd,kBAAkB,GACnB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,aAAa,EACb,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,WAAW,EACX,6BAA6B,GAC9B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,mBAAmB,YAAY,CAAC;AAChC,OAAO,EACL,oCAAoC,EACpC,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EACzB,6BAA6B,EAC7B,uBAAuB,EACvB,6BAA6B,EAC7B,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,qBAAqB,CAEtE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,kBAAkB,GACzB,sBAAsB,CAExB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,KAAK,CACzB,YAAY,EAAE,MAAM,GAAG,YAAY,EACnC,OAAO,GAAE,YAAY,GAAG;IACtB,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACtB,GACL,OAAO,CAAC,gBAAgB,CAAC,CAqB3B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -42,6 +42,7 @@ export { defineArtifacts } from "./artifacts.js";
 // Authoring helpers (also available on their focused subpath exports).
 export { allowAll, bearerAuth, DELETE, defineChannel, GET, httpChannel, localDev, localDevStrict, loopbackGitHubDev, loopbackOnly, PATCH, POST, PUT, publicEndpoint, } from "./channels.js";
 export { defineConnection } from "./connections.js";
+export { BUILTINS, bindMailboxContinuationSend, CONTINUATION_SELECTORS, continuationSource, defaultContinuationSelector, extractContinuation, formatConversationKey, handshakeContinuation, isContinuationSelector, mintClaim, normalizeIdentity, parseContinuationSelector, resolveContinuation, resolveV2Key, stampMailboxContinuation, V2EngineError, } from "./continuation.js";
 export { defineHook } from "./hooks.js";
 export { formatDiagnostics, hasErrorDiagnostics, isAgentProjectDir, loadAgentProject, loadAgentProjects, projectInfo, resolveAgentMounts, } from "./internal/discovery.js";
 export { collectGitHubTriggerTargets, collectOriginTriggerTargets, handleAgentServeTrigger, } from "./internal/handleAgentServeTrigger.js";
@@ -59,7 +60,9 @@ export { defineTool } from "./tools.js";
 export { cursorAccountServersHasMixedWildcard, DEFAULT_MODEL, DIRECT_TOOL_CALL_CHANNEL_ID, isCursorAccountTransport, isPeerConnectionTransport, isSymbolicConnectionTransport, MAX_RUNNING_TURNS_LIMIT, normalizeCursorAccountServers, supportsKvCas, } from "./types.js";
 /**
  * Runtime config for an agent — authored at `agent/agent.ts` (the root
- * agent) or `agent/subagents/<id>/agent.ts` (a subagent).
+ * agent) or `agent/subagents/<id>/agent.ts` (a subagent). Set
+ * `architecture: "v2"` to deploy onto the v2 control plane; omitted
+ * channel continuation then inherits kind `/v2` defaults.
  */
 export function defineAgent(config) {
     return brandDefinition("agent", config);

package/dist/internal/continuation-channel.d.ts

@@ -0,0 +1,29 @@
+import type { AgentArchitecture, ChannelDefinition, HttpChannelDefinition } from "../types.js";
+import { type ContinuationIdentity } from "./continuation-identity.js";
+export declare function channelContinuationIdentity(definition: object | undefined): ContinuationIdentity;
+export declare function httpContinuationIdentity(httpChannel: HttpChannelDefinition | undefined): ContinuationIdentity;
+/**
+ * Stamp `/v2` continuation defaults onto channel constructors that omitted
+ * `continuation` when the agent deploys onto v2 architecture. GitHub/Origin
+ * type (`pr` / `issue` / `none`) follows declared webhook events. Explicit
+ * per-channel selectors are left alone. Idempotent.
+ */
+export declare function applyAgentContinuationDefaults(project: {
+    agent: {
+        architecture?: AgentArchitecture;
+    };
+    channels: ReadonlyArray<{
+        definition: object;
+    }>;
+    httpChannel: HttpChannelDefinition;
+}): void;
+export declare function handshakeChannelContinuation(input: {
+    id: string;
+    definition: ChannelDefinition;
+}): {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+//# sourceMappingURL=continuation-channel.d.ts.map

package/dist/internal/continuation-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation-channel.d.ts","sourceRoot":"","sources":["../../src/internal/continuation-channel.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,oBAAoB,EAK1B,MAAM,4BAA4B,CAAC;AAEpC,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,oBAAoB,CAiBtB;AAED,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,qBAAqB,GAAG,SAAS,GAC7C,oBAAoB,CAEtB;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE;IACtD,KAAK,EAAE;QAAE,YAAY,CAAC,EAAE,iBAAiB,CAAA;KAAE,CAAC;IAC5C,QAAQ,EAAE,aAAa,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,WAAW,EAAE,qBAAqB,CAAC;CACpC,GAAG,IAAI,CAaP;AA4CD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,iBAAiB,CAAC;CAC/B,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAe9C"}

package/dist/internal/continuation-channel.js

@@ -0,0 +1,88 @@
+import { getGitHubChannelOptions } from "../channels/github/github-channel.js";
+import { getOriginChannelOptions } from "../channels/origin/origin-channel.js";
+import { getSlackChannelOptions } from "../channels/slack/slack-channel.js";
+import { defaultContinuationSelector, handshakeContinuation, normalizeIdentity, } from "./continuation-identity.js";
+export function channelContinuationIdentity(definition) {
+    if (definition === undefined) {
+        return defaultContinuationSelector();
+    }
+    const github = getGitHubChannelOptions(definition);
+    if (github !== undefined) {
+        return normalizeIdentity(github.continuation, "github");
+    }
+    const slack = getSlackChannelOptions(definition);
+    if (slack !== undefined) {
+        return normalizeIdentity(slack.continuation, "slack");
+    }
+    const origin = getOriginChannelOptions(definition);
+    if (origin !== undefined) {
+        return normalizeIdentity(origin.continuation, "origin");
+    }
+    return defaultContinuationSelector();
+}
+export function httpContinuationIdentity(httpChannel) {
+    return normalizeIdentity(httpChannel === null || httpChannel === void 0 ? void 0 : httpChannel.continuation, "http");
+}
+/**
+ * Stamp `/v2` continuation defaults onto channel constructors that omitted
+ * `continuation` when the agent deploys onto v2 architecture. GitHub/Origin
+ * type (`pr` / `issue` / `none`) follows declared webhook events. Explicit
+ * per-channel selectors are left alone. Idempotent.
+ */
+export function applyAgentContinuationDefaults(project) {
+    if (project.agent.architecture !== "v2") {
+        return;
+    }
+    for (const channel of project.channels) {
+        stampOmittedChannelContinuation(channel.definition, "v2");
+    }
+    if (project.httpChannel.continuation === undefined) {
+        project.httpChannel.continuation = defaultContinuationSelector("http", "v2");
+    }
+}
+function stampOmittedChannelContinuation(definition, version) {
+    const events = declaredChannelEventTypes(definition);
+    const github = getGitHubChannelOptions(definition);
+    if (github !== undefined) {
+        if (github.continuation === undefined) {
+            github.continuation = defaultContinuationSelector("github", version, events);
+        }
+        return;
+    }
+    const slack = getSlackChannelOptions(definition);
+    if (slack !== undefined) {
+        if (slack.continuation === undefined) {
+            slack.continuation = defaultContinuationSelector("slack", version);
+        }
+        return;
+    }
+    const origin = getOriginChannelOptions(definition);
+    if (origin !== undefined) {
+        if (origin.continuation === undefined) {
+            origin.continuation = defaultContinuationSelector("origin", version, events);
+        }
+    }
+}
+function declaredChannelEventTypes(definition) {
+    var _a;
+    const meta = definition.meta;
+    return (_a = meta === null || meta === void 0 ? void 0 : meta.githubWebhookEvents) !== null && _a !== void 0 ? _a : meta === null || meta === void 0 ? void 0 : meta.originWebhookEvents;
+}
+export function handshakeChannelContinuation(input) {
+    var _a, _b, _c;
+    var _d, _e;
+    const kind = (_a = input.definition.meta) === null || _a === void 0 ? void 0 : _a.kind;
+    const eventTypes = [
+        ...((_d = (_b = input.definition.meta) === null || _b === void 0 ? void 0 : _b.githubWebhookEvents) !== null && _d !== void 0 ? _d : []),
+        ...((_e = (_c = input.definition.meta) === null || _c === void 0 ? void 0 : _c.originWebhookEvents) !== null && _e !== void 0 ? _e : []),
+    ];
+    const result = handshakeContinuation({
+        kind,
+        eventTypes,
+        identity: channelContinuationIdentity(input.definition),
+    });
+    if (!result.ok) {
+        return { ok: false, error: `channel ${input.id}: ${result.error}` };
+    }
+    return result;
+}

package/dist/internal/continuation-identity.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Continuation identity is a closed selector string. Omitted `continuation`
+ * on a channel constructor stays `/v1` (engine pack minting) so existing
+ * agents do not change: `githubChannel()` → `github.pr/v1`, `slackChannel()`
+ * → `slack.thread/v1`, `originChannel()` → `origin.pr/v1`, `httpChannel()`
+ * → `none/v1`.
+ *
+ * Opt the whole agent into the v2 control plane with
+ * `defineAgent({ architecture: "v2" })`. That stamps `/v2` defaults from
+ * the channel kind and declared events (`github.pr/v2`, `github.issue/v2`,
+ * `github.none/v2`, `slack.thread/v2`, …) onto every channel that omitted
+ * a selector. An explicit per-channel selector still overrides. JSONPath
+ * and per-agent format strings are rejected.
+ */
+export type ConversationType = "pr" | "issue" | "thread" | "origin-pr";
+export declare const CONTINUATION_SELECTORS: readonly ["github.pr/v1", "github.pr/v2", "github.issue/v1", "github.issue/v2", "github.none/v2", "slack.thread/v1", "slack.thread/v2", "slack.none/v2", "origin.pr/v1", "origin.pr/v2", "origin.none/v2", "none/v1", "none/v2"];
+export type ContinuationSelector = (typeof CONTINUATION_SELECTORS)[number];
+export type ContinuationIdentity = ContinuationSelector;
+/** Agent-root protocol version. Omit / `"v1"` keeps engine minting. */
+export type ContinuationProtocolVersion = "v1" | "v2";
+export type ParsedContinuation = {
+    selector: ContinuationSelector;
+    version: 1 | 2;
+    type: ConversationType | "none";
+    kind: "github" | "slack" | "origin" | "http";
+};
+export type ContinuationClaim = {
+    type: ConversationType;
+    resource: {
+        owner: string;
+        repo: string;
+        number: number;
+    } | {
+        channelId: string;
+        threadTs: string;
+    } | {
+        fullName: string;
+        number: number;
+    };
+};
+export type MailboxContinuation = {
+    key: string;
+};
+export type ContinuationBuiltin = {
+    type: ConversationType;
+    kind: "github" | "slack" | "origin";
+    events: readonly string[];
+    format: string;
+};
+export declare const BUILTINS: readonly ContinuationBuiltin[];
+export declare class V2EngineError extends Error {
+    constructor(message: string);
+}
+export declare function isContinuationSelector(value: string): value is ContinuationSelector;
+export declare function defaultContinuationSelector(kind?: string, version?: ContinuationProtocolVersion, eventTypes?: readonly string[]): ContinuationSelector;
+export declare function parseContinuationSelector(selector: string): ParsedContinuation | undefined;
+export declare function resolveContinuation(raw?: ContinuationIdentity, kind?: string): ParsedContinuation;
+export declare function normalizeIdentity(raw?: ContinuationIdentity, kind?: string): ContinuationIdentity;
+export declare function continuationSource(identity?: ContinuationIdentity, kind?: string): "engine" | "control-plane";
+export declare function isV2DurableContinuationKey(key: string): boolean;
+export declare function newEvtKey(): string;
+export declare function builtinForType(type: ConversationType): ContinuationBuiltin | undefined;
+export declare function formatConversationKey(type: ConversationType, fields: {
+    fullName?: string;
+    number?: number;
+    channelId?: string;
+    threadTs?: string;
+}): string;
+export declare function mintClaim(claim: ContinuationClaim): string;
+export declare function handshakeContinuation(input: {
+    kind?: string;
+    eventTypes?: readonly string[];
+    identity?: ContinuationIdentity;
+}): {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * CP/pack extract. Returns a `cont:` key when the payload binds the
+ * identity type; undefined on membership miss or missing number (caller
+ * stamps `evt:` and does not join the conversation index).
+ */
+export declare function extractContinuation(type: ConversationType, eventName: string, payload: unknown): string | undefined;
+export declare function stampMailboxContinuation(identity: ContinuationIdentity, eventName: string, payload: unknown, kind?: string): MailboxContinuation;
+export declare function resolveV2Key(identity: ContinuationIdentity, options: {
+    claim?: ContinuationClaim;
+    continuationToken?: string;
+    mailboxContinuation?: MailboxContinuation;
+}, kind?: string): string;
+export declare function bindMailboxContinuationSend<TSession, TOptions extends {
+    mailboxContinuation?: MailboxContinuation;
+}>(send: (message: string, options?: TOptions) => Promise<TSession>, mailbox: MailboxContinuation | undefined): (message: string, options?: TOptions) => Promise<TSession>;
+//# sourceMappingURL=continuation-identity.d.ts.map

package/dist/internal/continuation-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation-identity.d.ts","sourceRoot":"","sources":["../../src/internal/continuation-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEvE,eAAO,MAAM,sBAAsB,YACjC,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,SAAS,CACD,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC3E,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AACxD,uEAAuE;AACvE,MAAM,MAAM,2BAA2B,GAAG,IAAI,GAAG,IAAI,CAAC;AAEtD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IACf,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAAC;IAChC,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EACJ;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAC/C;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GACvC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,SAAS,mBAAmB,EAyCzC,CAAC;AAEX,qBAAa,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAoBD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,oBAAoB,CAE/B;AAED,wBAAgB,2BAA2B,CACzC,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,GAAE,2BAAkC,EAC3C,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,GAC7B,oBAAoB,CAuBtB;AAwBD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,GACf,kBAAkB,GAAG,SAAS,CAKhC;AAED,wBAAgB,mBAAmB,CACjC,GAAG,CAAC,EAAE,oBAAoB,EAC1B,IAAI,CAAC,EAAE,MAAM,GACZ,kBAAkB,CASpB;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,CAAC,EAAE,oBAAoB,EAC1B,IAAI,CAAC,EAAE,MAAM,GACZ,oBAAoB,CAEtB;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,CAAC,EAAE,oBAAoB,EAC/B,IAAI,CAAC,EAAE,MAAM,GACZ,QAAQ,GAAG,eAAe,CAI5B;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,gBAAgB,GACrB,mBAAmB,GAAG,SAAS,CAEjC;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE;IACN,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,MAAM,CAWR;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAqB1D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CACjC,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAyC9C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,gBAAgB,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,GACf,MAAM,GAAG,SAAS,CAiBpB;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,oBAAoB,EAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,mBAAmB,CAarB;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,EAAE;IACP,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C,EACD,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM,CA8BR;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EACR,QAAQ,SAAS;IAAE,mBAAmB,CAAC,EAAE,mBAAmB,CAAA;CAAE,EAE9D,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,EAChE,OAAO,EAAE,mBAAmB,GAAG,SAAS,GACvC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,CAS5D"}