@convex-dev/agent 0.0.16-alpha.0 → 0.0.17-alpha.0

package/dist/esm/client/playground.d.ts

@@ -1,15 +1,16 @@
 import { GenericDataModel, GenericQueryCtx, ApiFromModules } from "convex/server";
-import { type Agent } from "./index";
-import type { UseApi } from "./types";
+import { type AgentComponent, type Agent } from "./index";
 import type { ToolSet } from "ai";
-import { Mounts } from "../component/_generated/api";
 export type PlaygroundAPI = ApiFromModules<{
-    playground: ReturnType<typeof definePlaygroundAPI<GenericDataModel>>;
+    playground: ReturnType<typeof definePlaygroundAPI>;
 }>["playground"];
-export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(component: UseApi<Mounts>, { agents, userNameLookup, }: {
+export declare function definePlaygroundAPI(component: AgentComponent, { agents, userNameLookup, }: {
     agents: Agent<ToolSet>[];
-    userNameLookup?: (ctx: GenericQueryCtx<DataModel>, userId: string) => string | Promise<string>;
+    userNameLookup?: <DataModel extends GenericDataModel>(ctx: GenericQueryCtx<DataModel>, userId: string) => string | Promise<string>;
 }): {
+    isApiKeyValid: import("convex/server").RegisteredQuery<"public", {
+        apiKey: string;
+    }, Promise<boolean>>;
     listUsers: import("convex/server").RegisteredQuery<"public", {
         apiKey: string;
         paginationOpts: {
@@ -22,7 +23,7 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
         };
     }, Promise<{
         page: {
-            id: string;
+            _id: string;
             name: string;
         }[];
         continueCursor: string;
@@ -77,102 +78,98 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
             agentName?: string | undefined;
             embeddingId?: string | string | string | string | string | string | string | string | string | undefined;
             error?: string | undefined;
-            fileId?: string | undefined;
+            files?: {
+                data?: (ArrayBuffer | string) | undefined;
+                fileId?: string | undefined;
+                mimeType: string;
+                url?: string | undefined;
+            }[] | undefined;
             finishReason?: "stop" | "length" | "content-filter" | "tool-calls" | "error" | "other" | "unknown" | undefined;
             id?: string | undefined;
             message?: {
                 content: string | ({
-                    experimental_providerMetadata?: {
-                        [x: string]: any;
-                    } | undefined;
                     providerOptions?: {
-                        [x: string]: any;
+                        [x: string]: {
+                            [x: string]: any;
+                        };
                     } | undefined;
                     text: string;
                     type: "text";
                 } | {
-                    experimental_providerMetadata?: {
-                        [x: string]: any;
-                    } | undefined;
                     image: string | ArrayBuffer;
                     mimeType?: string | undefined;
                     providerOptions?: {
-                        [x: string]: any;
+                        [x: string]: {
+                            [x: string]: any;
+                        };
                     } | undefined;
                     type: "image";
                 } | {
                     data: string | ArrayBuffer;
-                    experimental_providerMetadata?: {
-                        [x: string]: any;
-                    } | undefined;
                     mimeType: string;
                     providerOptions?: {
-                        [x: string]: any;
+                        [x: string]: {
+                            [x: string]: any;
+                        };
                     } | undefined;
                     type: "file";
                 })[];
-                experimental_providerMetadata?: {
-                    [x: string]: any;
-                } | undefined;
                 providerOptions?: {
-                    [x: string]: any;
+                    [x: string]: {
+                        [x: string]: any;
+                    };
                 } | undefined;
                 role: "user";
             } | {
                 content: string | ({
-                    experimental_providerMetadata?: {
-                        [x: string]: any;
-                    } | undefined;
                     providerOptions?: {
-                        [x: string]: any;
+                        [x: string]: {
+                            [x: string]: any;
+                        };
                     } | undefined;
                     text: string;
                     type: "text";
                 } | {
                     data: string | ArrayBuffer;
-                    experimental_providerMetadata?: {
-                        [x: string]: any;
-                    } | undefined;
                     mimeType: string;
                     providerOptions?: {
-                        [x: string]: any;
+                        [x: string]: {
+                            [x: string]: any;
+                        };
                     } | undefined;
                     type: "file";
                 } | {
-                    experimental_providerMetadata?: {
-                        [x: string]: any;
-                    } | undefined;
                     providerOptions?: {
-                        [x: string]: any;
+                        [x: string]: {
+                            [x: string]: any;
+                        };
                     } | undefined;
+                    signature?: string | undefined;
                     text: string;
                     type: "reasoning";
                 } | {
                     data: string;
-                    experimental_providerMetadata?: {
-                        [x: string]: any;
-                    } | undefined;
                     providerOptions?: {
-                        [x: string]: any;
+                        [x: string]: {
+                            [x: string]: any;
+                        };
                     } | undefined;
                     type: "redacted-reasoning";
                 } | {
                     args: any;
-                    experimental_providerMetadata?: {
-                        [x: string]: any;
-                    } | undefined;
                     providerOptions?: {
-                        [x: string]: any;
+                        [x: string]: {
+                            [x: string]: any;
+                        };
                     } | undefined;
                     toolCallId: string;
                     toolName: string;
                     type: "tool-call";
                 })[];
-                experimental_providerMetadata?: {
-                    [x: string]: any;
-                } | undefined;
                 providerOptions?: {
-                    [x: string]: any;
+                    [x: string]: {
+                        [x: string]: any;
+                    };
                 } | undefined;
                 role: "assistant";
             } | {
@@ -186,32 +183,29 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                         mimeType?: string | undefined;
                         type: "image";
                     })[] | undefined;
-                    experimental_providerMetadata?: {
-                        [x: string]: any;
-                    } | undefined;
                     isError?: boolean | undefined;
                     providerOptions?: {
-                        [x: string]: any;
+                        [x: string]: {
+                            [x: string]: any;
+                        };
                     } | undefined;
                     result: any;
                     toolCallId: string;
                     toolName: string;
                     type: "tool-result";
                 }[];
-                experimental_providerMetadata?: {
-                    [x: string]: any;
-                } | undefined;
                 providerOptions?: {
-                    [x: string]: any;
+                    [x: string]: {
+                        [x: string]: any;
+                    };
                 } | undefined;
                 role: "tool";
             } | {
                 content: string;
-                experimental_providerMetadata?: {
-                    [x: string]: any;
-                } | undefined;
                 providerOptions?: {
-                    [x: string]: any;
+                    [x: string]: {
+                        [x: string]: any;
+                    };
                 } | undefined;
                 role: "system";
             } | undefined;
@@ -220,12 +214,27 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
             parentMessageId?: string | undefined;
             provider?: string | undefined;
             providerMetadata?: {
-                [x: string]: any;
+                [x: string]: {
+                    [x: string]: any;
+                };
+            } | undefined;
+            providerOptions?: {
+                [x: string]: {
+                    [x: string]: any;
+                };
             } | undefined;
             reasoning?: string | undefined;
+            reasoningDetails?: ({
+                signature?: string | undefined;
+                text: string;
+                type: "text";
+            } | {
+                data: string;
+                type: "redacted";
+            })[] | undefined;
             sources?: {
                 id: string;
-                providerMetadata?: {
+                providerOptions?: {
                     [x: string]: {
                         [x: string]: any;
                     };
@@ -276,67 +285,56 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
     }>>;
     generateText: import("convex/server").RegisteredAction<"public", {
         messages?: ({
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "user";
             content: string | ({
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "text";
                 text: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 mimeType?: string | undefined;
                 type: "image";
                 image: string | ArrayBuffer;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "file";
                 mimeType: string;
                 data: string | ArrayBuffer;
             })[];
         } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "assistant";
             content: string | ({
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "text";
                 text: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "file";
                 mimeType: string;
                 data: string | ArrayBuffer;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                signature?: string | undefined;
                 type: "reasoning";
                 text: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "redacted-reasoning";
                 data: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
                 args: any;
             })[];
         } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "tool";
             content: {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 args?: any;
                 experimental_content?: ({
                     type: "text";
@@ -353,12 +351,30 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 result: any;
             }[];
         } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "system";
             content: string;
         })[] | undefined;
         prompt?: string | undefined;
+        contextOptions?: {
+            excludeToolMessages?: boolean | undefined;
+            recentMessages?: number | undefined;
+            searchOptions?: {
+                messageRange?: {
+                    before: number;
+                    after: number;
+                } | undefined;
+                textSearch?: boolean | undefined;
+                vectorSearch?: boolean | undefined;
+                limit: number;
+            } | undefined;
+            searchOtherThreads?: boolean | undefined;
+        } | undefined;
+        storageOptions?: {
+            saveAllInputMessages?: boolean | undefined;
+            saveAnyInputMessages?: boolean | undefined;
+            saveOutputMessages?: boolean | undefined;
+        } | undefined;
         userId: string;
         threadId: string;
         agentName: string;
@@ -371,67 +387,56 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
         threadId?: string | undefined;
         beforeMessageId?: string | undefined;
         messages: ({
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "user";
             content: string | ({
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "text";
                 text: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 mimeType?: string | undefined;
                 type: "image";
                 image: string | ArrayBuffer;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "file";
                 mimeType: string;
                 data: string | ArrayBuffer;
             })[];
         } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "assistant";
             content: string | ({
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "text";
                 text: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "file";
                 mimeType: string;
                 data: string | ArrayBuffer;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                signature?: string | undefined;
                 type: "reasoning";
                 text: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "redacted-reasoning";
                 data: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
                 args: any;
             })[];
         } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "tool";
             content: {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 args?: any;
                 experimental_content?: ({
                     type: "text";
@@ -448,14 +453,13 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 result: any;
             }[];
         } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "system";
             content: string;
         })[];
         agentName: string;
         contextOptions: {
-            includeToolCalls?: boolean | undefined;
+            excludeToolMessages?: boolean | undefined;
             recentMessages?: number | undefined;
             searchOptions?: {
                 messageRange?: {
@@ -469,6 +473,137 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
             searchOtherThreads?: boolean | undefined;
         };
         apiKey: string;
-    }, Promise<import("ai").CoreMessage[]>>;
+    }, Promise<{
+        id?: string | undefined;
+        userId?: string | undefined;
+        parentMessageId?: string | undefined;
+        stepId?: string | undefined;
+        embeddingId?: string | undefined;
+        error?: string | undefined;
+        agentName?: string | undefined;
+        model?: string | undefined;
+        provider?: string | undefined;
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        message?: {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            role: "user";
+            content: string | ({
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                type: "text";
+                text: string;
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                mimeType?: string | undefined;
+                type: "image";
+                image: string | ArrayBuffer;
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                type: "file";
+                mimeType: string;
+                data: string | ArrayBuffer;
+            })[];
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            role: "assistant";
+            content: string | ({
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                type: "text";
+                text: string;
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                type: "file";
+                mimeType: string;
+                data: string | ArrayBuffer;
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                signature?: string | undefined;
+                type: "reasoning";
+                text: string;
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                type: "redacted-reasoning";
+                data: string;
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                type: "tool-call";
+                toolCallId: string;
+                toolName: string;
+                args: any;
+            })[];
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            role: "tool";
+            content: {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                args?: any;
+                experimental_content?: ({
+                    type: "text";
+                    text: string;
+                } | {
+                    mimeType?: string | undefined;
+                    type: "image";
+                    data: string;
+                })[] | undefined;
+                isError?: boolean | undefined;
+                type: "tool-result";
+                toolCallId: string;
+                toolName: string;
+                result: any;
+            }[];
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            role: "system";
+            content: string;
+        } | undefined;
+        text?: string | undefined;
+        reasoning?: string | undefined;
+        files?: {
+            bytes?: ArrayBuffer | undefined;
+            url?: string | undefined;
+            fileId?: string | undefined;
+            mimeType: string;
+        }[] | undefined;
+        usage?: {
+            promptTokens: number;
+            completionTokens: number;
+            totalTokens: number;
+        } | undefined;
+        providerMetadata?: Record<string, Record<string, any>> | undefined;
+        sources?: {
+            title?: string | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            id: string;
+            url: string;
+            sourceType: "url";
+        }[] | undefined;
+        reasoningDetails?: ({
+            signature?: string | undefined;
+            type: "text";
+            text: string;
+        } | {
+            type: "redacted";
+            data: string;
+        })[] | undefined;
+        warnings?: ({
+            details?: string | undefined;
+            type: "unsupported-setting";
+            setting: string;
+        } | {
+            details?: string | undefined;
+            type: "unsupported-tool";
+            tool: any;
+        } | {
+            type: "other";
+            message: string;
+        })[] | undefined;
+        finishReason?: "length" | "error" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
+        status: "pending" | "success" | "failed";
+        order: number;
+        _creationTime: number;
+        threadId: string;
+        stepOrder: number;
+        tool: boolean;
+        _id: string;
+    }[]>>;
 };
 //# sourceMappingURL=playground.d.ts.map

package/dist/esm/client/playground.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playground.d.ts","sourceRoot":"","sources":["../../../src/client/playground.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,gBAAgB,EAChB,eAAe,EAGf,cAAc,EACf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAc,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAe,MAAM,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAElC,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAQrD,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC;IACzC,UAAU,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,CAAC;CACtE,CAAC,CAAC,YAAY,CAAC,CAAC;AAGjB,wBAAgB,mBAAmB,CAAC,SAAS,SAAS,gBAAgB,EACpE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EACzB,EACE,MAAM,EACN,cAAc,GACf,EAAE;IACD,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,CACf,GAAG,EAAE,eAAe,CAAC,SAAS,CAAC,EAC/B,MAAM,EAAE,MAAM,KACX,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+LF"}
+{"version":3,"file":"playground.d.ts","sourceRoot":"","sources":["../../../src/client/playground.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,gBAAgB,EAChB,eAAe,EACf,cAAc,EACf,MAAM,eAAe,CAAC;AACvB,OAAO,EAOL,KAAK,cAAc,EACnB,KAAK,KAAK,EACX,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAGlC,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC;IACzC,UAAU,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;CACpD,CAAC,CAAC,YAAY,CAAC,CAAC;AAGjB,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,cAAc,EACzB,EACE,MAAM,EACN,cAAc,GACf,EAAE;IACD,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,CAAC,SAAS,SAAS,gBAAgB,EAClD,GAAG,EAAE,eAAe,CAAC,SAAS,CAAC,EAC/B,MAAM,EAAE,MAAM,KACX,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwNF"}