@jinn-network/client 0.1.2 → 0.1.3-canary.262e5cda

package/dist/types/envelope.js

@@ -0,0 +1,114 @@
+/**
+ * jinn.execution.v1 — generic signed envelope.
+ *
+ * Scope: docs/superpowers/specs/2026-04-23-jinn-execution-envelope-tee-scope.md
+ * §3.1 (D5 + K1 knowledge tree), §3.2 (K3 executor provenance), §3.4 migration.
+ *
+ * One envelope shape covers restoration manifests (role='restoration') and
+ * verdict manifests (role='verdict'). Payload is typed per (kind, role) via
+ * the registry in `./payloads/`.
+ */
+import { z } from 'zod';
+import { WindowSchema } from './window.js';
+const HexStringSchema = z.string().regex(/^0x[0-9a-fA-F]*$/);
+export const EvidenceTierSchema = z.enum([
+    'self-signed',
+    'committed',
+    'attested',
+]);
+export const RoleSchema = z.enum(['restoration', 'verdict']);
+const IntentProvenanceSchema = z.object({
+    cid: z.string().min(1),
+    onchainCreationTx: HexStringSchema,
+    onchainCreationBlock: z.number().int(),
+    requestId: HexStringSchema,
+});
+const ParticipantSchema = z.object({
+    safeAddress: HexStringSchema,
+    agentEoa: HexStringSchema,
+});
+const SigningKeySchema = z.object({
+    kind: z.enum(['agent-eoa', 'enclave-bound']),
+    pubkey: HexStringSchema,
+});
+const SourceBundleSchema = z.object({
+    bundleCid: z.string().min(1),
+    sha256: z.string().regex(/^[0-9a-f]{64}$/),
+    humanUrl: z.string().optional(),
+    buildRecipe: z.object({
+        kind: z.enum(['dockerfile', 'nix', 'bazel']),
+        path: z.string(),
+    }),
+    measurement: HexStringSchema,
+});
+const ExecutorSchema = z.object({
+    implName: z.string().min(1),
+    implVersion: z.string().min(1),
+    clientGitSha: z.string().min(1),
+    codeDigest: z.string().regex(/^sha256:[0-9a-f]{64}$/),
+    signingKey: SigningKeySchema,
+    source: SourceBundleSchema.optional(),
+});
+const AttestationSchema = z.object({
+    profile: z.string().min(1),
+    quote: z.string(),
+    reportData: HexStringSchema,
+    measurement: HexStringSchema,
+});
+const TrajectoryRefSchema = z.object({
+    sha256: z.string().regex(/^[0-9a-f]{64}$/),
+    access: z.object({
+        endpoint: z.string().url(),
+        priceUsdc: z.string().regex(/^\d+(\.\d+)?$/),
+    }),
+});
+const ArtifactSchema = z.object({
+    artifactType: z.string().min(1),
+    sha256: z.string().regex(/^[0-9a-f]{64}$/),
+    metadata: z
+        .object({
+        description: z.string().optional(),
+        tags: z.array(z.string()).optional(),
+        producedBy: z
+            .object({
+            spanId: z.string(),
+            trajectoryCid: z.string(),
+        })
+            .optional(),
+    })
+        .optional(),
+    access: z.object({
+        endpoint: z.string().url(),
+        priceUsdc: z.string().regex(/^\d+(\.\d+)?$/),
+    }),
+});
+const SignatureSchema = z.object({
+    algo: z.literal('secp256k1'),
+    signer: HexStringSchema,
+    hash: HexStringSchema,
+    sig: HexStringSchema,
+});
+const BaseEnvelopeFields = {
+    schemaVersion: z.literal('jinn.execution.v1'),
+    kind: z.string().min(1),
+    role: RoleSchema,
+    generatedAt: z.number().int(),
+    intent: IntentProvenanceSchema,
+    participant: ParticipantSchema,
+    window: WindowSchema,
+    executor: ExecutorSchema,
+    evidenceTier: EvidenceTierSchema,
+    attestation: AttestationSchema.nullable(),
+    trajectory: TrajectoryRefSchema.nullable(),
+    artifacts: z.array(ArtifactSchema),
+    payload: z.record(z.unknown()),
+};
+export const UnsignedEnvelopeSchema = z
+    .object(BaseEnvelopeFields)
+    .refine((e) => e.evidenceTier !== 'attested' || e.executor.source !== undefined, { message: 'attested tier requires executor.source', path: ['executor', 'source'] })
+    .refine((e) => e.evidenceTier !== 'attested' || e.attestation !== null, { message: 'attested tier requires attestation', path: ['attestation'] });
+export const SignedEnvelopeSchema = z
+    .object({ ...BaseEnvelopeFields, signature: SignatureSchema })
+    .refine((e) => e.evidenceTier !== 'attested' || e.executor.source !== undefined, { message: 'attested tier requires executor.source', path: ['executor', 'source'] })
+    .refine((e) => e.evidenceTier !== 'attested' || e.attestation !== null, { message: 'attested tier requires attestation', path: ['attestation'] });
+//# sourceMappingURL=envelope.js.map

package/dist/types/envelope.js.map

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

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
-export { type DesiredState, type RequestId, type RestorationRequest, type RestorationResult, type DeliveredResult, type Window, parseDesiredState, WindowSchema, DesiredStateSchema, } from './desired-state.js';
-export { PortfolioV0SpecSchema, PortfolioV0EligibilitySchema, PortfolioV0IntentSchema, RestorationManifestSchema, VerdictManifestSchema, type Artifact, type PortfolioV0Spec, type PortfolioV0Eligibility, type PortfolioV0Intent, type RestorationManifest, type VerdictManifest, } from './portfolio.js';
+export { type RestorationJob, type RequestId, type RestorationRequest, type RestorationResult, type DeliveredResult, type Window, parseRestorationJob, WindowSchema, RestorationJobSchema, } from './desired-state.js';
+export { PortfolioV0SpecSchema, PortfolioV0EligibilitySchema, PortfolioV0IntentSchema, type Artifact, type PortfolioV0Spec, type PortfolioV0Eligibility, type PortfolioV0Intent, } from './portfolio.js';
 export { TransientError, PermanentError } from './errors.js';
-export { PredictionV0SpecSchema, PredictionV0EligibilitySchema, PredictionV0IntentSchema, PredictionSubmissionManifestSchema, PredictionVerdictManifestSchema, type PredictionV0Spec, type PredictionV0Eligibility, type PredictionV0Intent, type PredictionSubmissionManifest, type PredictionVerdictManifest, } from './prediction.js';
-export { PredictionApyV0SpecSchema, PredictionApyV0EligibilitySchema, PredictionApyV0IntentSchema, PredictionApySubmissionManifestSchema, PredictionApyVerdictManifestSchema, type PredictionApyV0Spec, type PredictionApyV0Eligibility, type PredictionApyV0Intent, type PredictionApySubmissionManifest, type PredictionApyVerdictManifest, } from './prediction-apy.js';
+export { PredictionV0SpecSchema, PredictionV0EligibilitySchema, PredictionV0IntentSchema, type PredictionV0Spec, type PredictionV0Eligibility, type PredictionV0Intent, } from './prediction.js';
+export { PredictionApyV0SpecSchema, PredictionApyV0EligibilitySchema, PredictionApyV0IntentSchema, type PredictionApyV0Spec, type PredictionApyV0Eligibility, type PredictionApyV0Intent, } from './prediction-apy.js';

package/dist/types/index.js

@@ -1,6 +1,6 @@
-export { parseDesiredState, WindowSchema, DesiredStateSchema, } from './desired-state.js';
-export { PortfolioV0SpecSchema, PortfolioV0EligibilitySchema, PortfolioV0IntentSchema, RestorationManifestSchema, VerdictManifestSchema, } from './portfolio.js';
+export { parseRestorationJob, WindowSchema, RestorationJobSchema, } from './desired-state.js';
+export { PortfolioV0SpecSchema, PortfolioV0EligibilitySchema, PortfolioV0IntentSchema, } from './portfolio.js';
 export { TransientError, PermanentError } from './errors.js';
-export { PredictionV0SpecSchema, PredictionV0EligibilitySchema, PredictionV0IntentSchema, PredictionSubmissionManifestSchema, PredictionVerdictManifestSchema, } from './prediction.js';
-export { PredictionApyV0SpecSchema, PredictionApyV0EligibilitySchema, PredictionApyV0IntentSchema, PredictionApySubmissionManifestSchema, PredictionApyVerdictManifestSchema, } from './prediction-apy.js';
+export { PredictionV0SpecSchema, PredictionV0EligibilitySchema, PredictionV0IntentSchema, } from './prediction.js';
+export { PredictionApyV0SpecSchema, PredictionApyV0EligibilitySchema, PredictionApyV0IntentSchema, } from './prediction-apy.js';
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,GAOtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,wBAAwB,EACxB,kCAAkC,EAClC,+BAA+B,GAMhC,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,yBAAyB,EACzB,gCAAgC,EAChC,2BAA2B,EAC3B,qCAAqC,EACrC,kCAAkC,GAMnC,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,GAKxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,wBAAwB,GAIzB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,yBAAyB,EACzB,gCAAgC,EAChC,2BAA2B,GAI5B,MAAM,qBAAqB,CAAC"}

package/dist/types/intent.d.ts

@@ -0,0 +1,276 @@
+/**
+ * intent.v1 — canonical signed intent document.
+ *
+ * Scope: docs/superpowers/specs/2026-04-23-jinn-execution-envelope-tee-scope.md §3.1 (K2).
+ *
+ * An `intent.v1` is the IPFS-addressed, signed document that declares:
+ *   - what objective is being requested (kind + spec)
+ *   - who created it (Safe + agent EOA)
+ *   - when it was created (UTC ms)
+ *   - when it applies (window)
+ *   - per-kind eligibility rules
+ *
+ * Its CID is the root of every knowledge-tree query (restoration envelopes
+ * reference `intent.cid`; verdict envelopes reference the same). The signed
+ * form is what lives on IPFS; the unsigned canonical form (JCS of intent
+ * minus `signature`) is what gets hashed + signed.
+ */
+import { z } from 'zod';
+export declare const IntentV1Schema: z.ZodEffects<z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"intent.v1">;
+    id: z.ZodString;
+    kind: z.ZodString;
+    description: z.ZodString;
+    window: z.ZodObject<{
+        startTs: z.ZodNumber;
+        endTs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        startTs: number;
+        endTs: number;
+    }, {
+        startTs: number;
+        endTs: number;
+    }>;
+    spec: z.ZodIntersection<z.ZodObject<{
+        kind: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: string;
+    }, {
+        kind: string;
+    }>, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    eligibility: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    creator: z.ZodObject<{
+        safeAddress: z.ZodString;
+        agentEoa: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        safeAddress: string;
+        agentEoa: string;
+    }, {
+        safeAddress: string;
+        agentEoa: string;
+    }>;
+    createdAt: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    schemaVersion: "intent.v1";
+    kind: string;
+    description: string;
+    window: {
+        startTs: number;
+        endTs: number;
+    };
+    spec: {
+        kind: string;
+    } & Record<string, unknown>;
+    eligibility: Record<string, unknown>;
+    creator: {
+        safeAddress: string;
+        agentEoa: string;
+    };
+    createdAt: number;
+}, {
+    id: string;
+    schemaVersion: "intent.v1";
+    kind: string;
+    description: string;
+    window: {
+        startTs: number;
+        endTs: number;
+    };
+    spec: {
+        kind: string;
+    } & Record<string, unknown>;
+    eligibility: Record<string, unknown>;
+    creator: {
+        safeAddress: string;
+        agentEoa: string;
+    };
+    createdAt: number;
+}>, {
+    id: string;
+    schemaVersion: "intent.v1";
+    kind: string;
+    description: string;
+    window: {
+        startTs: number;
+        endTs: number;
+    };
+    spec: {
+        kind: string;
+    } & Record<string, unknown>;
+    eligibility: Record<string, unknown>;
+    creator: {
+        safeAddress: string;
+        agentEoa: string;
+    };
+    createdAt: number;
+}, {
+    id: string;
+    schemaVersion: "intent.v1";
+    kind: string;
+    description: string;
+    window: {
+        startTs: number;
+        endTs: number;
+    };
+    spec: {
+        kind: string;
+    } & Record<string, unknown>;
+    eligibility: Record<string, unknown>;
+    creator: {
+        safeAddress: string;
+        agentEoa: string;
+    };
+    createdAt: number;
+}>;
+export type IntentV1 = z.infer<typeof IntentV1Schema>;
+export declare const SignedIntentV1Schema: z.ZodEffects<z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"intent.v1">;
+    id: z.ZodString;
+    kind: z.ZodString;
+    description: z.ZodString;
+    window: z.ZodObject<{
+        startTs: z.ZodNumber;
+        endTs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        startTs: number;
+        endTs: number;
+    }, {
+        startTs: number;
+        endTs: number;
+    }>;
+    spec: z.ZodIntersection<z.ZodObject<{
+        kind: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: string;
+    }, {
+        kind: string;
+    }>, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    eligibility: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    creator: z.ZodObject<{
+        safeAddress: z.ZodString;
+        agentEoa: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        safeAddress: string;
+        agentEoa: string;
+    }, {
+        safeAddress: string;
+        agentEoa: string;
+    }>;
+    createdAt: z.ZodNumber;
+    signature: z.ZodObject<{
+        algo: z.ZodLiteral<"secp256k1">;
+        signer: z.ZodString;
+        hash: z.ZodString;
+        sig: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        hash: string;
+        algo: "secp256k1";
+        signer: string;
+        sig: string;
+    }, {
+        hash: string;
+        algo: "secp256k1";
+        signer: string;
+        sig: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    signature: {
+        hash: string;
+        algo: "secp256k1";
+        signer: string;
+        sig: string;
+    };
+    schemaVersion: "intent.v1";
+    kind: string;
+    description: string;
+    window: {
+        startTs: number;
+        endTs: number;
+    };
+    spec: {
+        kind: string;
+    } & Record<string, unknown>;
+    eligibility: Record<string, unknown>;
+    creator: {
+        safeAddress: string;
+        agentEoa: string;
+    };
+    createdAt: number;
+}, {
+    id: string;
+    signature: {
+        hash: string;
+        algo: "secp256k1";
+        signer: string;
+        sig: string;
+    };
+    schemaVersion: "intent.v1";
+    kind: string;
+    description: string;
+    window: {
+        startTs: number;
+        endTs: number;
+    };
+    spec: {
+        kind: string;
+    } & Record<string, unknown>;
+    eligibility: Record<string, unknown>;
+    creator: {
+        safeAddress: string;
+        agentEoa: string;
+    };
+    createdAt: number;
+}>, {
+    id: string;
+    signature: {
+        hash: string;
+        algo: "secp256k1";
+        signer: string;
+        sig: string;
+    };
+    schemaVersion: "intent.v1";
+    kind: string;
+    description: string;
+    window: {
+        startTs: number;
+        endTs: number;
+    };
+    spec: {
+        kind: string;
+    } & Record<string, unknown>;
+    eligibility: Record<string, unknown>;
+    creator: {
+        safeAddress: string;
+        agentEoa: string;
+    };
+    createdAt: number;
+}, {
+    id: string;
+    signature: {
+        hash: string;
+        algo: "secp256k1";
+        signer: string;
+        sig: string;
+    };
+    schemaVersion: "intent.v1";
+    kind: string;
+    description: string;
+    window: {
+        startTs: number;
+        endTs: number;
+    };
+    spec: {
+        kind: string;
+    } & Record<string, unknown>;
+    eligibility: Record<string, unknown>;
+    creator: {
+        safeAddress: string;
+        agentEoa: string;
+    };
+    createdAt: number;
+}>;
+export type SignedIntentV1 = z.infer<typeof SignedIntentV1Schema>;
+export declare function parseIntentV1(input: unknown): IntentV1;
+export declare function parseSignedIntentV1(input: unknown): SignedIntentV1;

package/dist/types/intent.js

@@ -0,0 +1,74 @@
+/**
+ * intent.v1 — canonical signed intent document.
+ *
+ * Scope: docs/superpowers/specs/2026-04-23-jinn-execution-envelope-tee-scope.md §3.1 (K2).
+ *
+ * An `intent.v1` is the IPFS-addressed, signed document that declares:
+ *   - what objective is being requested (kind + spec)
+ *   - who created it (Safe + agent EOA)
+ *   - when it was created (UTC ms)
+ *   - when it applies (window)
+ *   - per-kind eligibility rules
+ *
+ * Its CID is the root of every knowledge-tree query (restoration envelopes
+ * reference `intent.cid`; verdict envelopes reference the same). The signed
+ * form is what lives on IPFS; the unsigned canonical form (JCS of intent
+ * minus `signature`) is what gets hashed + signed.
+ */
+import { z } from 'zod';
+import { WindowSchema } from './window.js';
+const HexStringSchema = z
+    .string()
+    .regex(/^0x[0-9a-fA-F]*$/, 'must be a 0x-prefixed hex string');
+const SignatureSchema = z.object({
+    algo: z.literal('secp256k1'),
+    signer: HexStringSchema,
+    hash: HexStringSchema,
+    sig: HexStringSchema,
+});
+const CreatorSchema = z.object({
+    safeAddress: HexStringSchema,
+    agentEoa: HexStringSchema,
+});
+export const IntentV1Schema = z
+    .object({
+    schemaVersion: z.literal('intent.v1'),
+    id: z.string().min(1),
+    kind: z.string().min(1),
+    description: z.string().min(1),
+    window: WindowSchema,
+    spec: z
+        .object({ kind: z.string() })
+        .and(z.record(z.unknown())),
+    eligibility: z.record(z.unknown()),
+    creator: CreatorSchema,
+    createdAt: z.number().int(),
+})
+    .refine((d) => d.kind === d.spec.kind, {
+    message: 'top-level kind and spec.kind must match',
+    path: ['spec', 'kind'],
+});
+export const SignedIntentV1Schema = z
+    .object({
+    schemaVersion: z.literal('intent.v1'),
+    id: z.string().min(1),
+    kind: z.string().min(1),
+    description: z.string().min(1),
+    window: WindowSchema,
+    spec: z.object({ kind: z.string() }).and(z.record(z.unknown())),
+    eligibility: z.record(z.unknown()),
+    creator: CreatorSchema,
+    createdAt: z.number().int(),
+    signature: SignatureSchema,
+})
+    .refine((d) => d.kind === d.spec.kind, {
+    message: 'top-level kind and spec.kind must match',
+    path: ['spec', 'kind'],
+});
+export function parseIntentV1(input) {
+    return IntentV1Schema.parse(input);
+}
+export function parseSignedIntentV1(input) {
+    return SignedIntentV1Schema.parse(input);
+}
+//# sourceMappingURL=intent.js.map

package/dist/types/intent.js.map

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

package/dist/types/payloads/index.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import type { Role } from '../envelope.js';
+/**
+ * Registry mapping (kind, role) → payload schema.
+ * Update when adding a new kind.
+ */
+export declare const KIND_PAYLOADS: Record<string, Record<Role, z.ZodSchema>>;
+export declare function validatePayload(kind: string, role: Role, payload: unknown): void;
+export * from './portfolio-v0.js';
+export * from './prediction-v0.js';
+export * from './prediction-apy-v0.js';

package/dist/types/payloads/index.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { PortfolioV0RestorationPayloadSchema, PortfolioV0VerdictPayloadSchema, } from './portfolio-v0.js';
+import { PredictionV0RestorationPayloadSchema, PredictionV0VerdictPayloadSchema, } from './prediction-v0.js';
+import { PredictionApyV0RestorationPayloadSchema, PredictionApyV0VerdictPayloadSchema, } from './prediction-apy-v0.js';
+/**
+ * Passthrough payload schema for legacy / untyped intents.
+ * Accepts any object — no structural validation.
+ */
+const LegacyPassthroughSchema = z.record(z.unknown());
+/**
+ * Registry mapping (kind, role) → payload schema.
+ * Update when adding a new kind.
+ */
+export const KIND_PAYLOADS = {
+    'portfolio.v0': {
+        restoration: PortfolioV0RestorationPayloadSchema,
+        verdict: PortfolioV0VerdictPayloadSchema,
+    },
+    'prediction.v0': {
+        restoration: PredictionV0RestorationPayloadSchema,
+        verdict: PredictionV0VerdictPayloadSchema,
+    },
+    'prediction.apy.v0': {
+        restoration: PredictionApyV0RestorationPayloadSchema,
+        verdict: PredictionApyV0VerdictPayloadSchema,
+    },
+    // Passthrough kind for legacy / untyped intents (no spec.kind).
+    // Produced by the legacy-claude impl; no structural validation on payload.
+    'legacy.v0': {
+        restoration: LegacyPassthroughSchema,
+        verdict: LegacyPassthroughSchema,
+    },
+};
+export function validatePayload(kind, role, payload) {
+    const bucket = KIND_PAYLOADS[kind];
+    if (!bucket)
+        throw new Error(`Unknown kind: ${kind}`);
+    const schema = bucket[role];
+    if (!schema)
+        throw new Error(`No payload schema for (${kind}, ${role})`);
+    schema.parse(payload);
+}
+export * from './portfolio-v0.js';
+export * from './prediction-v0.js';
+export * from './prediction-apy-v0.js';
+//# sourceMappingURL=index.js.map

package/dist/types/payloads/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/payloads/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,mCAAmC,EACnC,+BAA+B,GAChC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,oCAAoC,EACpC,gCAAgC,GACjC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,uCAAuC,EACvC,mCAAmC,GACpC,MAAM,wBAAwB,CAAC;AAGhC;;;GAGG;AACH,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAEtD;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAA8C;IACtE,cAAc,EAAE;QACd,WAAW,EAAE,mCAAmC;QAChD,OAAO,EAAE,+BAA+B;KACzC;IACD,eAAe,EAAE;QACf,WAAW,EAAE,oCAAoC;QACjD,OAAO,EAAE,gCAAgC;KAC1C;IACD,mBAAmB,EAAE;QACnB,WAAW,EAAE,uCAAuC;QACpD,OAAO,EAAE,mCAAmC;KAC7C;IACD,gEAAgE;IAChE,2EAA2E;IAC3E,WAAW,EAAE;QACX,WAAW,EAAE,uBAAuB;QACpC,OAAO,EAAE,uBAAuB;KACjC;CACF,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,IAAU,EAAE,OAAgB;IACxE,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,KAAK,IAAI,GAAG,CAAC,CAAC;IACzE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACxB,CAAC;AAED,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC"}