@archastro/sdk 0.18.0 → 0.19.0

package/dist/types/ai.d.ts

@@ -736,6 +736,304 @@ export declare const aICompletionResultSchema: z.ZodObject<{
     finish_reason: string;
     token_usage?: Record<string, {} | null> | undefined;
 }>;
+/** Probability that the statement is true, in `[0, 1]`. */
+export interface AIEvaluationAnswerBoolean {
+    id: string;
+    probability: number;
+    type: "boolean";
+}
+/** Runtime validator for {@link AIEvaluationAnswerBoolean}. */
+export declare const aIEvaluationAnswerBooleanSchema: z.ZodObject<{
+    id: z.ZodString;
+    probability: z.ZodNumber;
+    type: z.ZodLiteral<"boolean">;
+}, "strip", z.ZodTypeAny, {
+    type: "boolean";
+    id: string;
+    probability: number;
+}, {
+    type: "boolean";
+    id: string;
+    probability: number;
+}>;
+/** Selected option plus the full probability distribution. */
+export interface AIEvaluationAnswerChoice {
+    choice: string;
+    confidence?: number | undefined;
+    id: string;
+    probabilities: Record<string, unknown>;
+    type: "choice";
+}
+/** Runtime validator for {@link AIEvaluationAnswerChoice}. */
+export declare const aIEvaluationAnswerChoiceSchema: z.ZodObject<{
+    choice: z.ZodString;
+    confidence: z.ZodOptional<z.ZodNumber>;
+    id: z.ZodString;
+    probabilities: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
+    type: z.ZodLiteral<"choice">;
+}, "strip", z.ZodTypeAny, {
+    type: "choice";
+    id: string;
+    choice: string;
+    probabilities: Record<string, {} | null>;
+    confidence?: number | undefined;
+}, {
+    type: "choice";
+    id: string;
+    choice: string;
+    probabilities: Record<string, {} | null>;
+    confidence?: number | undefined;
+}>;
+/** Probability-weighted position along the caller-defined levels. */
+export interface AIEvaluationAnswerScore {
+    confidence?: number | undefined;
+    id: string;
+    legend: Record<string, unknown>;
+    probabilities: Record<string, unknown>;
+    score: number;
+    type: "score";
+}
+/** Runtime validator for {@link AIEvaluationAnswerScore}. */
+export declare const aIEvaluationAnswerScoreSchema: z.ZodObject<{
+    confidence: z.ZodOptional<z.ZodNumber>;
+    id: z.ZodString;
+    legend: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
+    probabilities: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
+    score: z.ZodNumber;
+    type: z.ZodLiteral<"score">;
+}, "strip", z.ZodTypeAny, {
+    type: "score";
+    id: string;
+    score: number;
+    probabilities: Record<string, {} | null>;
+    legend: Record<string, {} | null>;
+    confidence?: number | undefined;
+}, {
+    type: "score";
+    id: string;
+    score: number;
+    probabilities: Record<string, {} | null>;
+    legend: Record<string, {} | null>;
+    confidence?: number | undefined;
+}>;
+/**
+ * One typed evaluation answer. `type` selects boolean, choice, or score.
+ * `id` matches the question id.
+ */
+export declare const aIEvaluationAnswerSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    id: z.ZodString;
+    probability: z.ZodNumber;
+    type: z.ZodLiteral<"boolean">;
+}, "strip", z.ZodTypeAny, {
+    type: "boolean";
+    id: string;
+    probability: number;
+}, {
+    type: "boolean";
+    id: string;
+    probability: number;
+}>, z.ZodObject<{
+    choice: z.ZodString;
+    confidence: z.ZodOptional<z.ZodNumber>;
+    id: z.ZodString;
+    probabilities: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
+    type: z.ZodLiteral<"choice">;
+}, "strip", z.ZodTypeAny, {
+    type: "choice";
+    id: string;
+    choice: string;
+    probabilities: Record<string, {} | null>;
+    confidence?: number | undefined;
+}, {
+    type: "choice";
+    id: string;
+    choice: string;
+    probabilities: Record<string, {} | null>;
+    confidence?: number | undefined;
+}>, z.ZodObject<{
+    confidence: z.ZodOptional<z.ZodNumber>;
+    id: z.ZodString;
+    legend: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
+    probabilities: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
+    score: z.ZodNumber;
+    type: z.ZodLiteral<"score">;
+}, "strip", z.ZodTypeAny, {
+    type: "score";
+    id: string;
+    score: number;
+    probabilities: Record<string, {} | null>;
+    legend: Record<string, {} | null>;
+    confidence?: number | undefined;
+}, {
+    type: "score";
+    id: string;
+    score: number;
+    probabilities: Record<string, {} | null>;
+    legend: Record<string, {} | null>;
+    confidence?: number | undefined;
+}>]>;
+/**
+ * One typed evaluation answer. `type` selects boolean, choice, or score.
+ * `id` matches the question id.
+ */
+export type AIEvaluationAnswer = z.infer<typeof aIEvaluationAnswerSchema>;
+/** Token counts for one evaluation request. */
+export interface AIEvaluationUsage {
+    /** Provider-reported input tokens. `null` when the provider omitted the count. */
+    input_tokens?: number | undefined;
+    /** Provider-reported output tokens. `null` when the provider omitted the count. */
+    output_tokens?: number | undefined;
+}
+/** Runtime validator for {@link AIEvaluationUsage}. */
+export declare const aIEvaluationUsageSchema: z.ZodObject<{
+    /** Provider-reported input tokens. `null` when the provider omitted the count. */
+    input_tokens: z.ZodOptional<z.ZodNumber>;
+    /** Provider-reported output tokens. `null` when the provider omitted the count. */
+    output_tokens: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    input_tokens?: number | undefined;
+    output_tokens?: number | undefined;
+}, {
+    input_tokens?: number | undefined;
+    output_tokens?: number | undefined;
+}>;
+/**
+ * Result of an evaluation request: typed answers, the model that ran, and
+ * token usage.
+ */
+export interface AIEvaluationResult {
+    /** Typed answers. Each value is a boolean, choice, or score object with the question `id`. */
+    answers: AIEvaluationAnswer[];
+    /** Model identifier that produced the answers. */
+    model: string;
+    /** UUID grouping this evaluation's usage record. Generated when omitted on the request. */
+    session_id?: string | undefined;
+    /** Token usage for this request. `null` when usage data is unavailable. */
+    usage?: AIEvaluationUsage | undefined;
+}
+/** Runtime validator for {@link AIEvaluationResult}. */
+export declare const aIEvaluationResultSchema: z.ZodObject<{
+    /** Typed answers. Each value is a boolean, choice, or score object with the question `id`. */
+    answers: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        id: z.ZodString;
+        probability: z.ZodNumber;
+        type: z.ZodLiteral<"boolean">;
+    }, "strip", z.ZodTypeAny, {
+        type: "boolean";
+        id: string;
+        probability: number;
+    }, {
+        type: "boolean";
+        id: string;
+        probability: number;
+    }>, z.ZodObject<{
+        choice: z.ZodString;
+        confidence: z.ZodOptional<z.ZodNumber>;
+        id: z.ZodString;
+        probabilities: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
+        type: z.ZodLiteral<"choice">;
+    }, "strip", z.ZodTypeAny, {
+        type: "choice";
+        id: string;
+        choice: string;
+        probabilities: Record<string, {} | null>;
+        confidence?: number | undefined;
+    }, {
+        type: "choice";
+        id: string;
+        choice: string;
+        probabilities: Record<string, {} | null>;
+        confidence?: number | undefined;
+    }>, z.ZodObject<{
+        confidence: z.ZodOptional<z.ZodNumber>;
+        id: z.ZodString;
+        legend: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
+        probabilities: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
+        score: z.ZodNumber;
+        type: z.ZodLiteral<"score">;
+    }, "strip", z.ZodTypeAny, {
+        type: "score";
+        id: string;
+        score: number;
+        probabilities: Record<string, {} | null>;
+        legend: Record<string, {} | null>;
+        confidence?: number | undefined;
+    }, {
+        type: "score";
+        id: string;
+        score: number;
+        probabilities: Record<string, {} | null>;
+        legend: Record<string, {} | null>;
+        confidence?: number | undefined;
+    }>]>, "many">;
+    /** Model identifier that produced the answers. */
+    model: z.ZodString;
+    /** UUID grouping this evaluation's usage record. Generated when omitted on the request. */
+    session_id: z.ZodOptional<z.ZodString>;
+    /** Token usage for this request. `null` when usage data is unavailable. */
+    usage: z.ZodOptional<z.ZodObject<{
+        /** Provider-reported input tokens. `null` when the provider omitted the count. */
+        input_tokens: z.ZodOptional<z.ZodNumber>;
+        /** Provider-reported output tokens. `null` when the provider omitted the count. */
+        output_tokens: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
+    }, {
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    model: string;
+    answers: ({
+        type: "boolean";
+        id: string;
+        probability: number;
+    } | {
+        type: "choice";
+        id: string;
+        choice: string;
+        probabilities: Record<string, {} | null>;
+        confidence?: number | undefined;
+    } | {
+        type: "score";
+        id: string;
+        score: number;
+        probabilities: Record<string, {} | null>;
+        legend: Record<string, {} | null>;
+        confidence?: number | undefined;
+    })[];
+    usage?: {
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
+    } | undefined;
+    session_id?: string | undefined;
+}, {
+    model: string;
+    answers: ({
+        type: "boolean";
+        id: string;
+        probability: number;
+    } | {
+        type: "choice";
+        id: string;
+        choice: string;
+        probabilities: Record<string, {} | null>;
+        confidence?: number | undefined;
+    } | {
+        type: "score";
+        id: string;
+        score: number;
+        probabilities: Record<string, {} | null>;
+        legend: Record<string, {} | null>;
+        confidence?: number | undefined;
+    })[];
+    usage?: {
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
+    } | undefined;
+    session_id?: string | undefined;
+}>;
 /** The result returned by an AI image generation or editing operation. Contains the generated image (as inline data or a URL) along with dimension, size, and usage metadata. */
 export interface AIImageResult {
     /** Aspect ratio of the generated image, e.g. `"16:9"` or `"1:1"`. `null` when not reported by the provider. */
@@ -754,10 +1052,14 @@ export interface AIImageResult {
     model: string;
     /** The prompt as rewritten by the provider before generation. Some providers (e.g. DALL-E 3) automatically expand or safety-check the original prompt. `null` when the provider does not revise prompts. */
     revised_prompt?: string | undefined;
+    /** UUID grouping this image request's provider attempts for usage and billing. */
+    session_id?: string | undefined;
     /** Canonical size string as returned by the provider, e.g. `"1024x1024"`. `null` when not reported. */
     size?: string | undefined;
     /** Provider-reported token and compute usage for the request. Structure varies by provider. `null` when usage data is unavailable. */
     usage?: Record<string, unknown> | undefined;
+    /** Number of provider responses contributing usage records to this request, including image-generation retries. */
+    usage_attempt_count?: number | undefined;
     /** Width of the generated image in pixels. `null` when the provider does not report dimensions. */
     width?: number | undefined;
 }
@@ -779,10 +1081,14 @@ export declare const aIImageResultSchema: z.ZodObject<{
     model: z.ZodString;
     /** The prompt as rewritten by the provider before generation. Some providers (e.g. DALL-E 3) automatically expand or safety-check the original prompt. `null` when the provider does not revise prompts. */
     revised_prompt: z.ZodOptional<z.ZodString>;
+    /** UUID grouping this image request's provider attempts for usage and billing. */
+    session_id: z.ZodOptional<z.ZodString>;
     /** Canonical size string as returned by the provider, e.g. `"1024x1024"`. `null` when not reported. */
     size: z.ZodOptional<z.ZodString>;
     /** Provider-reported token and compute usage for the request. Structure varies by provider. `null` when usage data is unavailable. */
     usage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>>;
+    /** Number of provider responses contributing usage records to this request, including image-generation retries. */
+    usage_attempt_count: z.ZodOptional<z.ZodNumber>;
     /** Width of the generated image in pixels. `null` when the provider does not report dimensions. */
     width: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
@@ -792,11 +1098,13 @@ export declare const aIImageResultSchema: z.ZodObject<{
     image_url?: string | undefined;
     size?: string | undefined;
     usage?: Record<string, {} | null> | undefined;
+    session_id?: string | undefined;
     aspect_ratio?: string | undefined;
     image_data?: string | undefined;
     image_size?: string | undefined;
     image_type?: string | undefined;
     revised_prompt?: string | undefined;
+    usage_attempt_count?: number | undefined;
 }, {
     model: string;
     height?: number | undefined;
@@ -804,10 +1112,12 @@ export declare const aIImageResultSchema: z.ZodObject<{
     image_url?: string | undefined;
     size?: string | undefined;
     usage?: Record<string, {} | null> | undefined;
+    session_id?: string | undefined;
     aspect_ratio?: string | undefined;
     image_data?: string | undefined;
     image_size?: string | undefined;
     image_type?: string | undefined;
     revised_prompt?: string | undefined;
+    usage_attempt_count?: number | undefined;
 }>;
 //# sourceMappingURL=ai.d.ts.map

package/dist/types/ai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/types/ai.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wFAAwF;AACxF,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,uHAAuH;IACvH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAClD,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC7C;AAED,sDAAsD;AACtD,eAAO,MAAM,sBAAsB;IACjC,oDAAoD;;IAEpD,sFAAsF;;IAEtF,uHAAuH;;IAEvH,wDAAwD;;;;;;;;;;;;EAE4E,CAAC;AAEvI,gFAAgF;AAChF,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,uDAAuD;AACvD,eAAO,MAAM,uBAAuB;IAClC,0EAA0E;;;;;;EAEmD,CAAC;AAEhI,wHAAwH;AACxH,MAAM,WAAW,UAAU;IACzB,0JAA0J;IAC1J,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,yIAAyI;IACzI,EAAE,EAAE,MAAM,CAAC;IACX,mGAAmG;IACnG,IAAI,EAAE,MAAM,CAAC;IACb,+JAA+J;IAC/J,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED,gDAAgD;AAChD,eAAO,MAAM,gBAAgB;IAC3B,0JAA0J;;IAE1J,yIAAyI;;IAEzI,mGAAmG;;IAEnG,+JAA+J;;;;;;;;;;;;EAED,CAAC;AAEjK,6IAA6I;AAC7I,MAAM,WAAW,YAAY;IAC3B,2HAA2H;IAC3H,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,0GAA0G;IAC1G,EAAE,EAAE,MAAM,CAAC;IACX,sIAAsI;IACtI,IAAI,EAAE,MAAM,CAAC;IACb,4IAA4I;IAC5I,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClC;AAED,kDAAkD;AAClD,eAAO,MAAM,kBAAkB;IAC7B,2HAA2H;;IAE3H,0GAA0G;;IAE1G,sIAAsI;;IAEtI,4IAA4I;;;;;;;;;;;;EAEyC,CAAC;AAExL,iJAAiJ;AACjJ,MAAM,WAAW,SAAS;IACxB,oLAAoL;IACpL,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,oNAAoN;IACpN,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC;IACtD,qLAAqL;IACrL,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,kGAAkG;IAClG,IAAI,EAAE,MAAM,CAAC;IACb,kNAAkN;IAClN,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,wKAAwK;IACxK,UAAU,CAAC,EAAE,UAAU,EAAE,GAAG,SAAS,CAAC;IACtC,uJAAuJ;IACvJ,YAAY,CAAC,EAAE,YAAY,EAAE,GAAG,SAAS,CAAC;CAC3C;AAED,+CAA+C;AAC/C,eAAO,MAAM,eAAe;IAC1B,oLAAoL;;IAEpL,oNAAoN;;IAEpN,qLAAqL;;IAErL,kGAAkG;;IAElG,kNAAkN;;IAElN,wKAAwK;;QAhExK,0JAA0J;;QAE1J,yIAAyI;;QAEzI,mGAAmG;;QAEnG,+JAA+J;;;;;;;;;;;;;IA4D/J,uJAAuJ;;QA1CvJ,2HAA2H;;QAE3H,0GAA0G;;QAE1G,sIAAsI;;QAEtI,4IAA4I;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsC0C,CAAC;AAEzL,uHAAuH;AACvH,MAAM,WAAW,2BAA2B;IAC1C,mGAAmG;IACnG,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,wFAAwF;IACxF,OAAO,EAAE,SAAS,CAAC;IACnB,gGAAgG;IAChG,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC7C;AAED,iEAAiE;AACjE,eAAO,MAAM,iCAAiC;IAC5C,mGAAmG;;IAEnG,wFAAwF;;QA9BxF,oLAAoL;;QAEpL,oNAAoN;;QAEpN,qLAAqL;;QAErL,kGAAkG;;QAElG,kNAAkN;;QAElN,wKAAwK;;YAhExK,0JAA0J;;YAE1J,yIAAyI;;YAEzI,mGAAmG;;YAEnG,+JAA+J;;;;;;;;;;;;;QA4D/J,uJAAuJ;;YA1CvJ,2HAA2H;;YAE3H,0GAA0G;;YAE1G,sIAAsI;;YAEtI,4IAA4I;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwD5I,gGAAgG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE8E,CAAC;AAEjL,yGAAyG;AACzG,MAAM,WAAW,wBAAwB;IACvC,6IAA6I;IAC7I,KAAK,EAAE,MAAM,CAAC;CACf;AAED,8DAA8D;AAC9D,eAAO,MAAM,8BAA8B;IACzC,6IAA6I;;;;;;EAEgB,CAAC;AAEhK,2GAA2G;AAC3G,MAAM,WAAW,yBAAyB;IACxC,uFAAuF;IACvF,KAAK,EAAE,MAAM,CAAC;CACf;AAED,+DAA+D;AAC/D,eAAO,MAAM,+BAA+B;IAC1C,uFAAuF;;;;;;EAEyE,CAAC;AAEnK,iHAAiH;AACjH,MAAM,WAAW,yBAAyB;IACxC,6GAA6G;IAC7G,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,0FAA0F;IAC1F,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,+DAA+D;AAC/D,eAAO,MAAM,+BAA+B;IAC1C,6GAA6G;;IAE7G,0FAA0F;;IAE1F,iDAAiD;;;;;;;;;;EAEqH,CAAC;AAEzK,kGAAkG;AAClG,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,iDAAiD;IACjD,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,4DAA4D;AAC5D,eAAO,MAAM,4BAA4B;IACvC,iDAAiD;;IAEjD,iDAAiD;;IAEjD,kDAAkD;;IAElD,4DAA4D;;;;;;;;;;;;EAEwF,CAAC;AAEvJ,8HAA8H;AAC9H,MAAM,WAAW,kBAAkB;IACjC,8KAA8K;IAC9K,aAAa,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,OAAO,EAAE,SAAS,CAAC;IACnB,oHAAoH;IACpH,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,oKAAoK;IACpK,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CACnD;AAED,wDAAwD;AACxD,eAAO,MAAM,wBAAwB;IACnC,8KAA8K;;IAE9K,8DAA8D;;QAxH9D,oLAAoL;;QAEpL,oNAAoN;;QAEpN,qLAAqL;;QAErL,kGAAkG;;QAElG,kNAAkN;;QAElN,wKAAwK;;YAhExK,0JAA0J;;YAE1J,yIAAyI;;YAEzI,mGAAmG;;YAEnG,+JAA+J;;;;;;;;;;;;;QA4D/J,uJAAuJ;;YA1CvJ,2HAA2H;;YAE3H,0GAA0G;;YAE1G,sIAAsI;;YAEtI,4IAA4I;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkJ5I,oHAAoH;;QA1HpH,oLAAoL;;QAEpL,oNAAoN;;QAEpN,qLAAqL;;QAErL,kGAAkG;;QAElG,kNAAkN;;QAElN,wKAAwK;;YAhExK,0JAA0J;;YAE1J,yIAAyI;;YAEzI,mGAAmG;;YAEnG,+JAA+J;;;;;;;;;;;;;QA4D/J,uJAAuJ;;YA1CvJ,2HAA2H;;YAE3H,0GAA0G;;YAE1G,sIAAsI;;YAEtI,4IAA4I;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAoJ5I,oKAAoK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEQ,CAAC;AAE/K,iLAAiL;AACjL,MAAM,WAAW,aAAa;IAC5B,+GAA+G;IAC/G,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,oGAAoG;IACpG,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,mJAAmJ;IACnJ,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,0HAA0H;IAC1H,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,uIAAuI;IACvI,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,sLAAsL;IACtL,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,4MAA4M;IAC5M,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,uGAAuG;IACvG,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,sIAAsI;IACtI,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC5C,mGAAmG;IACnG,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,mDAAmD;AACnD,eAAO,MAAM,mBAAmB;IAC9B,+GAA+G;;IAE/G,oGAAoG;;IAEpG,mJAAmJ;;IAEnJ,0HAA0H;;IAE1H,uIAAuI;;IAEvI,sLAAsL;;IAEtL,0FAA0F;;IAE1F,4MAA4M;;IAE5M,uGAAuG;;IAEvG,sIAAsI;;IAEtI,mGAAmG;;;;;;;;;;;;;;;;;;;;;;;;;;EAEuH,CAAC"}
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/types/ai.ts"],"names":[],"mappings":"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"}

package/dist/types/ai.js

@@ -1,6 +1,6 @@
 // Copyright (c) 2026 ArchAstro Inc. Licensed under the MIT License.
 // This file is auto-generated by @archastro/sdk-generator. Do not edit.
-// Content hash: 935df40aa8b4
+// Content hash: ba7d38c074da
 import { z } from "zod";
 /** Runtime validator for {@link AIChatStreamDone}. */
 export const aIChatStreamDoneSchema = z.object({
@@ -107,6 +107,52 @@ export const aICompletionResultSchema = z.object({
     /** Token consumption breakdown keyed by model ID. Each value is a map with `"input_tokens"` and `"output_tokens"` counts. `null` when usage data is unavailable. */
     token_usage: z.record(z.custom((value) => value !== undefined)).optional().describe("Token consumption breakdown keyed by model ID. Each value is a map with `\"input_tokens\"` and `\"output_tokens\"` counts. `null` when usage data is unavailable."),
 }).describe("The result of an AI chat completion request. Returned by chat completion endpoints after the model finishes generating.");
+/** Runtime validator for {@link AIEvaluationAnswerBoolean}. */
+export const aIEvaluationAnswerBooleanSchema = z.object({
+    id: z.string(),
+    probability: z.number(),
+    type: z.literal("boolean"),
+}).describe("Probability that the statement is true, in `[0, 1]`.");
+/** Runtime validator for {@link AIEvaluationAnswerChoice}. */
+export const aIEvaluationAnswerChoiceSchema = z.object({
+    choice: z.string(),
+    confidence: z.number().optional(),
+    id: z.string(),
+    probabilities: z.record(z.custom((value) => value !== undefined)),
+    type: z.literal("choice"),
+}).describe("Selected option plus the full probability distribution.");
+/** Runtime validator for {@link AIEvaluationAnswerScore}. */
+export const aIEvaluationAnswerScoreSchema = z.object({
+    confidence: z.number().optional(),
+    id: z.string(),
+    legend: z.record(z.custom((value) => value !== undefined)),
+    probabilities: z.record(z.custom((value) => value !== undefined)),
+    score: z.number(),
+    type: z.literal("score"),
+}).describe("Probability-weighted position along the caller-defined levels.");
+/**
+ * One typed evaluation answer. `type` selects boolean, choice, or score.
+ * `id` matches the question id.
+ */
+export const aIEvaluationAnswerSchema = z.discriminatedUnion("type", [aIEvaluationAnswerBooleanSchema, aIEvaluationAnswerChoiceSchema, aIEvaluationAnswerScoreSchema]);
+/** Runtime validator for {@link AIEvaluationUsage}. */
+export const aIEvaluationUsageSchema = z.object({
+    /** Provider-reported input tokens. `null` when the provider omitted the count. */
+    input_tokens: z.number().int().optional().describe("Provider-reported input tokens. `null` when the provider omitted the count."),
+    /** Provider-reported output tokens. `null` when the provider omitted the count. */
+    output_tokens: z.number().int().optional().describe("Provider-reported output tokens. `null` when the provider omitted the count."),
+}).describe("Token counts for one evaluation request.");
+/** Runtime validator for {@link AIEvaluationResult}. */
+export const aIEvaluationResultSchema = z.object({
+    /** Typed answers. Each value is a boolean, choice, or score object with the question `id`. */
+    answers: z.array(aIEvaluationAnswerSchema).describe("Typed answers. Each value is a boolean, choice, or score object with the question `id`."),
+    /** Model identifier that produced the answers. */
+    model: z.string().describe("Model identifier that produced the answers."),
+    /** UUID grouping this evaluation's usage record. Generated when omitted on the request. */
+    session_id: z.string().optional().describe("UUID grouping this evaluation's usage record. Generated when omitted on the request."),
+    /** Token usage for this request. `null` when usage data is unavailable. */
+    usage: aIEvaluationUsageSchema.optional().describe("Token usage for this request. `null` when usage data is unavailable."),
+}).describe("Result of an evaluation request: typed answers, the model that ran, and token usage.");
 /** Runtime validator for {@link AIImageResult}. */
 export const aIImageResultSchema = z.object({
     /** Aspect ratio of the generated image, e.g. `"16:9"` or `"1:1"`. `null` when not reported by the provider. */
@@ -125,10 +171,14 @@ export const aIImageResultSchema = z.object({
     model: z.string().describe("Identifier of the model that produced the image, e.g. `\"dall-e-3\"` or `\"imagen-3\"`."),
     /** The prompt as rewritten by the provider before generation. Some providers (e.g. DALL-E 3) automatically expand or safety-check the original prompt. `null` when the provider does not revise prompts. */
     revised_prompt: z.string().optional().describe("The prompt as rewritten by the provider before generation. Some providers (e.g. DALL-E 3) automatically expand or safety-check the original prompt. `null` when the provider does not revise prompts."),
+    /** UUID grouping this image request's provider attempts for usage and billing. */
+    session_id: z.string().optional().describe("UUID grouping this image request's provider attempts for usage and billing."),
     /** Canonical size string as returned by the provider, e.g. `"1024x1024"`. `null` when not reported. */
     size: z.string().optional().describe("Canonical size string as returned by the provider, e.g. `\"1024x1024\"`. `null` when not reported."),
     /** Provider-reported token and compute usage for the request. Structure varies by provider. `null` when usage data is unavailable. */
     usage: z.record(z.custom((value) => value !== undefined)).optional().describe("Provider-reported token and compute usage for the request. Structure varies by provider. `null` when usage data is unavailable."),
+    /** Number of provider responses contributing usage records to this request, including image-generation retries. */
+    usage_attempt_count: z.number().int().optional().describe("Number of provider responses contributing usage records to this request, including image-generation retries."),
     /** Width of the generated image in pixels. `null` when the provider does not report dimensions. */
     width: z.number().int().optional().describe("Width of the generated image in pixels. `null` when the provider does not report dimensions."),
 }).describe("The result returned by an AI image generation or editing operation. Contains the generated image (as inline data or a URL) along with dimension, size, and usage metadata.");

package/dist/types/ai.js.map

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

package/dist/types/artifacts.d.ts

@@ -18,6 +18,8 @@ export interface Artifact {
     file_name?: string | undefined;
     /** Short-lived signed URL for downloading the current version's file. `null` if no file is attached. */
     file_url?: string | undefined;
+    /** Optional nonunique, case-sensitive grouping key, limited to 1024 UTF-8 bytes. Null when unset; belongs to the artifact, not a content version. */
+    group_key?: string | null | undefined;
     /** Artifact ID (`art_...`). */
     id: string;
     /** Image source metadata for rendering the current version's file inline. Present only when `content_type` starts with `"image/"`. `null` otherwise. */
@@ -28,6 +30,8 @@ export interface Artifact {
     org?: string | undefined;
     /** Identifier of the sandbox environment associated with this artifact. `null` if not sandbox-scoped. */
     sandbox?: string | undefined;
+    /** True when the artifact has no user, team, or agent owner. An organization may own a system artifact. */
+    system?: boolean | undefined;
     /** ID of the team that owns this artifact (`tea_...`). `null` if not team-scoped. */
     team?: string | undefined;
     /** ID of the thread in which this artifact was created (`thr_...`). `null` if not thread-scoped. */
@@ -57,6 +61,8 @@ export declare const artifactSchema: z.ZodObject<{
     file_name: z.ZodOptional<z.ZodString>;
     /** Short-lived signed URL for downloading the current version's file. `null` if no file is attached. */
     file_url: z.ZodOptional<z.ZodString>;
+    /** Optional nonunique, case-sensitive grouping key, limited to 1024 UTF-8 bytes. Null when unset; belongs to the artifact, not a content version. */
+    group_key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** Artifact ID (`art_...`). */
     id: z.ZodString;
     /** Image source metadata for rendering the current version's file inline. Present only when `content_type` starts with `"image/"`. `null` otherwise. */
@@ -91,6 +97,8 @@ export declare const artifactSchema: z.ZodObject<{
     org: z.ZodOptional<z.ZodString>;
     /** Identifier of the sandbox environment associated with this artifact. `null` if not sandbox-scoped. */
     sandbox: z.ZodOptional<z.ZodString>;
+    /** True when the artifact has no user, team, or agent owner. An organization may own a system artifact. */
+    system: z.ZodOptional<z.ZodBoolean>;
     /** ID of the team that owns this artifact (`tea_...`). `null` if not team-scoped. */
     team: z.ZodOptional<z.ZodString>;
     /** ID of the thread in which this artifact was created (`thr_...`). `null` if not thread-scoped. */
@@ -105,10 +113,10 @@ export declare const artifactSchema: z.ZodObject<{
     id: string;
     user?: string | undefined;
     name?: string | undefined;
+    org?: string | undefined;
     agent?: string | undefined;
     thread?: string | undefined;
     team?: string | undefined;
-    org?: string | undefined;
     description?: string | undefined;
     created_at?: string | undefined;
     updated_at?: string | undefined;
@@ -128,14 +136,16 @@ export declare const artifactSchema: z.ZodObject<{
     version?: number | undefined;
     file_name?: string | undefined;
     file_url?: string | undefined;
+    group_key?: string | null | undefined;
+    system?: boolean | undefined;
 }, {
     id: string;
     user?: string | undefined;
     name?: string | undefined;
+    org?: string | undefined;
     agent?: string | undefined;
     thread?: string | undefined;
     team?: string | undefined;
-    org?: string | undefined;
     description?: string | undefined;
     created_at?: string | undefined;
     updated_at?: string | undefined;
@@ -155,5 +165,7 @@ export declare const artifactSchema: z.ZodObject<{
     version?: number | undefined;
     file_name?: string | undefined;
     file_url?: string | undefined;
+    group_key?: string | null | undefined;
+    system?: boolean | undefined;
 }>;
 //# sourceMappingURL=artifacts.d.ts.map

package/dist/types/artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/types/artifacts.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,8GAA8G;AAC9G,MAAM,WAAW,QAAQ;IACvB,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,kHAAkH;IAClH,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,mHAAmH;IACnH,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,0FAA0F;IAC1F,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,2GAA2G;IAC3G,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,wGAAwG;IACxG,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,wJAAwJ;IACxJ,YAAY,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACvC,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,yGAAyG;IACzG,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,qFAAqF;IACrF,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,oGAAoG;IACpG,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,+FAA+F;IAC/F,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,8CAA8C;AAC9C,eAAO,MAAM,cAAc;IACzB,6FAA6F;;IAE7F,kHAAkH;;IAElH,sDAAsD;;IAEtD,mHAAmH;;IAEnH,4FAA4F;;IAE5F,0FAA0F;;IAE1F,2GAA2G;;IAE3G,wGAAwG;;IAExG,+BAA+B;;IAE/B,wJAAwJ;;;;;;;;;;;;;;;;;;;;;;;;;;IAExJ,mFAAmF;;IAEnF,mEAAmE;;IAEnE,yGAAyG;;IAEzG,qFAAqF;;IAErF,oGAAoG;;IAEpG,6DAA6D;;IAE7D,uFAAuF;;IAEvF,+FAA+F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEmD,CAAC"}
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/types/artifacts.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,8GAA8G;AAC9G,MAAM,WAAW,QAAQ;IACvB,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,kHAAkH;IAClH,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,mHAAmH;IACnH,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,0FAA0F;IAC1F,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,2GAA2G;IAC3G,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,wGAAwG;IACxG,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,qJAAqJ;IACrJ,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACtC,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,wJAAwJ;IACxJ,YAAY,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACvC,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,yGAAyG;IACzG,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,2GAA2G;IAC3G,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,qFAAqF;IACrF,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,oGAAoG;IACpG,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,+FAA+F;IAC/F,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,8CAA8C;AAC9C,eAAO,MAAM,cAAc;IACzB,6FAA6F;;IAE7F,kHAAkH;;IAElH,sDAAsD;;IAEtD,mHAAmH;;IAEnH,4FAA4F;;IAE5F,0FAA0F;;IAE1F,2GAA2G;;IAE3G,wGAAwG;;IAExG,qJAAqJ;;IAErJ,+BAA+B;;IAE/B,wJAAwJ;;;;;;;;;;;;;;;;;;;;;;;;;;IAExJ,mFAAmF;;IAEnF,mEAAmE;;IAEnE,yGAAyG;;IAEzG,2GAA2G;;IAE3G,qFAAqF;;IAErF,oGAAoG;;IAEpG,6DAA6D;;IAE7D,uFAAuF;;IAEvF,+FAA+F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEmD,CAAC"}

package/dist/types/artifacts.js

@@ -1,6 +1,6 @@
 // Copyright (c) 2026 ArchAstro Inc. Licensed under the MIT License.
 // This file is auto-generated by @archastro/sdk-generator. Do not edit.
-// Content hash: 98798bac8c24
+// Content hash: 0e1768d2cc71
 import { z } from "zod";
 import { imageSourceSchema } from "./image.js";
 /** Runtime validator for {@link Artifact}. */
@@ -21,6 +21,8 @@ export const artifactSchema = z.object({
     file_name: z.string().optional().describe("Original filename of the current version's file, e.g. `\"output.csv\"`. `null` if no file is attached."),
     /** Short-lived signed URL for downloading the current version's file. `null` if no file is attached. */
     file_url: z.string().optional().describe("Short-lived signed URL for downloading the current version's file. `null` if no file is attached."),
+    /** Optional nonunique, case-sensitive grouping key, limited to 1024 UTF-8 bytes. Null when unset; belongs to the artifact, not a content version. */
+    group_key: z.string().nullable().optional().describe("Optional nonunique, case-sensitive grouping key, limited to 1024 UTF-8 bytes. Null when unset; belongs to the artifact, not a content version."),
     /** Artifact ID (`art_...`). */
     id: z.string().describe("Artifact ID (`art_...`)."),
     /** Image source metadata for rendering the current version's file inline. Present only when `content_type` starts with `"image/"`. `null` otherwise. */
@@ -31,6 +33,8 @@ export const artifactSchema = z.object({
     org: z.string().optional().describe("ID of the organization this artifact belongs to (`org_...`)."),
     /** Identifier of the sandbox environment associated with this artifact. `null` if not sandbox-scoped. */
     sandbox: z.string().optional().describe("Identifier of the sandbox environment associated with this artifact. `null` if not sandbox-scoped."),
+    /** True when the artifact has no user, team, or agent owner. An organization may own a system artifact. */
+    system: z.boolean().optional().describe("True when the artifact has no user, team, or agent owner. An organization may own a system artifact."),
     /** ID of the team that owns this artifact (`tea_...`). `null` if not team-scoped. */
     team: z.string().optional().describe("ID of the team that owns this artifact (`tea_...`). `null` if not team-scoped."),
     /** ID of the thread in which this artifact was created (`thr_...`). `null` if not thread-scoped. */

package/dist/types/artifacts.js.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/types/artifacts.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,wEAAwE;AACxE,6BAA6B;AAE7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA2C/C,8CAA8C;AAC9C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,6FAA6F;IAC7F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wFAAwF,CAAC;IAC/H,kHAAkH;IAClH,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iHAAiH,CAAC;IAC/J,sDAAsD;IACtD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IAC7F,mHAAmH;IACnH,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8GAA8G,CAAC;IAC/J,4FAA4F;IAC5F,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uFAAuF,CAAC;IACpI,0FAA0F;IAC1F,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qFAAqF,CAAC;IAC3H,2GAA2G;IAC3G,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wGAAwG,CAAC;IACnJ,wGAAwG;IACxG,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mGAAmG,CAAC;IAC7I,+BAA+B;IAC/B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACnD,wJAAwJ;IACxJ,YAAY,EAAE,iBAAiB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qJAAqJ,CAAC;IAC1M,mFAAmF;IACnF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;IACtH,mEAAmE;IACnE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;IACnG,yGAAyG;IACzG,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oGAAoG,CAAC;IAC7I,qFAAqF;IACrF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;IACtH,oGAAoG;IACpG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+FAA+F,CAAC;IACvI,6DAA6D;IAC7D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;IACpG,uFAAuF;IACvF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kFAAkF,CAAC;IACxH,+FAA+F;IAC/F,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0FAA0F,CAAC;CAC1I,CAAC,CAAC,QAAQ,CAAC,yGAAyG,CAA+B,CAAC"}
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/types/artifacts.ts"],"names":[],"mappings":"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"}